@devvit/client 0.11.14-next-2025-05-05-765f3688c.0

package/LICENSE

@@ -0,0 +1,26 @@
+Copyright (c) 2023 Reddit Inc.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+
+1. Redistributions of source code must retain the above copyright
+   notice, this list of conditions and the following disclaimer.
+2. Redistributions in binary form must reproduce the above copyright
+   notice, this list of conditions and the following disclaimer in the
+   documentation and/or other materials provided with the distribution.
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+SUCH DAMAGE.

package/README.md

@@ -0,0 +1,3 @@
+# @devvit/client
+
+Web view library for client effects and debugging.

package/client-meta.min.json

@@ -0,0 +1,175 @@
+{
+  "inputs": {
+    "src/effects/contants.ts": {
+      "bytes": 201,
+      "imports": [],
+      "format": "esm"
+    },
+    "src/effects/emit-effect.ts": {
+      "bytes": 2213,
+      "imports": [
+        {
+          "path": "src/effects/contants.ts",
+          "kind": "import-statement",
+          "original": "./contants.js"
+        }
+      ],
+      "format": "esm"
+    },
+    "src/effects/navigate-to.ts": {
+      "bytes": 1043,
+      "imports": [
+        {
+          "path": "src/effects/emit-effect.ts",
+          "kind": "import-statement",
+          "original": "./emit-effect.js"
+        }
+      ],
+      "format": "esm"
+    },
+    "src/effects/helpers/assert-valid-form-fields.ts": {
+      "bytes": 1271,
+      "imports": [],
+      "format": "esm"
+    },
+    "src/effects/helpers/get-form-values.ts": {
+      "bytes": 1337,
+      "imports": [],
+      "format": "esm"
+    },
+    "src/effects/helpers/transform-form.ts": {
+      "bytes": 4194,
+      "imports": [],
+      "format": "esm"
+    },
+    "src/effects/types.ts": {
+      "bytes": 506,
+      "imports": [],
+      "format": "esm"
+    },
+    "src/effects/show-form.ts": {
+      "bytes": 2074,
+      "imports": [
+        {
+          "path": "src/effects/emit-effect.ts",
+          "kind": "import-statement",
+          "original": "./emit-effect.js"
+        },
+        {
+          "path": "src/effects/helpers/assert-valid-form-fields.ts",
+          "kind": "import-statement",
+          "original": "./helpers/assert-valid-form-fields.js"
+        },
+        {
+          "path": "src/effects/helpers/get-form-values.ts",
+          "kind": "import-statement",
+          "original": "./helpers/get-form-values.js"
+        },
+        {
+          "path": "src/effects/helpers/transform-form.ts",
+          "kind": "import-statement",
+          "original": "./helpers/transform-form.js"
+        },
+        {
+          "path": "src/effects/types.ts",
+          "kind": "import-statement",
+          "original": "./types.js"
+        }
+      ],
+      "format": "esm"
+    },
+    "src/effects/show-toast.ts": {
+      "bytes": 1015,
+      "imports": [
+        {
+          "path": "src/effects/emit-effect.ts",
+          "kind": "import-statement",
+          "original": "./emit-effect.js"
+        }
+      ],
+      "format": "esm"
+    },
+    "src/effects/index.ts": {
+      "bytes": 135,
+      "imports": [
+        {
+          "path": "src/effects/navigate-to.ts",
+          "kind": "import-statement",
+          "original": "./navigate-to.js"
+        },
+        {
+          "path": "src/effects/show-form.ts",
+          "kind": "import-statement",
+          "original": "./show-form.js"
+        },
+        {
+          "path": "src/effects/show-toast.ts",
+          "kind": "import-statement",
+          "original": "./show-toast.js"
+        }
+      ],
+      "format": "esm"
+    },
+    "src/index.ts": {
+      "bytes": 70,
+      "imports": [
+        {
+          "path": "src/effects/index.ts",
+          "kind": "import-statement",
+          "original": "./effects/index.js"
+        }
+      ],
+      "format": "esm"
+    }
+  },
+  "outputs": {
+    "dist/client.min.js.map": {
+      "imports": [],
+      "exports": [],
+      "inputs": {},
+      "bytes": 18965
+    },
+    "dist/client.min.js": {
+      "imports": [],
+      "exports": [
+        "navigateTo",
+        "showForm",
+        "showToast"
+      ],
+      "entryPoint": "src/index.ts",
+      "inputs": {
+        "src/effects/contants.ts": {
+          "bytesInOutput": 10
+        },
+        "src/effects/emit-effect.ts": {
+          "bytesInOutput": 377
+        },
+        "src/effects/navigate-to.ts": {
+          "bytesInOutput": 156
+        },
+        "src/effects/index.ts": {
+          "bytesInOutput": 0
+        },
+        "src/effects/helpers/assert-valid-form-fields.ts": {
+          "bytesInOutput": 357
+        },
+        "src/effects/helpers/get-form-values.ts": {
+          "bytesInOutput": 331
+        },
+        "src/effects/helpers/transform-form.ts": {
+          "bytesInOutput": 1664
+        },
+        "src/effects/show-form.ts": {
+          "bytesInOutput": 361
+        },
+        "src/effects/show-toast.ts": {
+          "bytesInOutput": 139
+        },
+        "src/index.ts": {
+          "bytesInOutput": 0
+        }
+      },
+      "bytes": 3488
+    }
+  }
+}

package/client.min.js

@@ -0,0 +1,2 @@
+var l=[3];var i=e=>new Promise(t=>{let o={scope:0,type:"devvit-internal",effect:e};if(l.includes(e.type)){let r=self.crypto.randomUUID();o.id=r;let n=s=>{s.data?.type==="devvit-message"&&s.data?.data?.id===r&&(t(s.data.data),window.removeEventListener("message",n))};window.addEventListener("message",n),window.parent.postMessage(o,"*")}else window.parent.postMessage(o,"*"),t(void 0)});function d(e){let t;typeof e=="string"?t=new URL(e).toString():t=new URL(e.permalink,"https://www.reddit.com").toString(),i({navigateToUrl:{url:t},type:5})}function a(e,t=new Set){for(let o of e){if(o.type==="group"){a(o.fields,t);continue}let r=o.name;if(t.has(r))throw new Error(`Duplicate field name: ${r}`);t.add(r)}F(e)}function F(e){for(let t of e)if(t.type==="string"&&t.isSecret&&t.scope!=="app")throw`Invalid setting: only app settings can be secrets. Add "scope: SettingScope.App" to field "${t.name}"`}function T(e){switch(e.fieldType){case 0:return e.stringValue;case 7:return e.stringValue;case 1:return e.stringValue;case 2:return e.numberValue;case 3:return e.boolValue;case 5:return e.selectionValue?.values??[];default:return}}function m(e){return Object.keys(e).reduce((t,o)=>{let r=T(e[o]);return r!==void 0&&(t[o]=r),t},{})}function p(e){return e.map(t=>{switch(t.type){case"string":return y(t);case"image":return v(t);case"paragraph":return g(t);case"number":return E(t);case"select":return b(t);case"boolean":return S(t);case"group":return h(t);default:throw new Error("Unknown field type.")}})}function y(e){return{defaultValue:{fieldType:0,stringValue:e.defaultValue},disabled:e.disabled,fieldConfig:{stringConfig:{placeholder:e.placeholder}},fieldId:e.name,fieldType:0,helpText:e.helpText,label:e.label,required:e.required,isSecret:e.isSecret}}function v(e){return{disabled:e.disabled,fieldId:e.name,fieldType:7,helpText:e.helpText,label:e.label,required:e.required}}function g(e){return{defaultValue:{fieldType:1,stringValue:e.defaultValue},disabled:e.disabled,fieldConfig:{paragraphConfig:{lineHeight:e.lineHeight,placeholder:e.placeholder}},fieldId:e.name,fieldType:1,helpText:e.helpText,label:e.label,required:e.required}}function E(e){return{defaultValue:{fieldType:2,numberValue:e.defaultValue},disabled:e.disabled,fieldConfig:{numberConfig:{}},fieldId:e.name,fieldType:2,helpText:e.helpText,label:e.label,required:e.required}}function b(e){return{defaultValue:{fieldType:5,selectionValue:{values:e.defaultValue??[]}},disabled:e.disabled,fieldConfig:{selectionConfig:{choices:e.options,multiSelect:e.multiSelect}},fieldId:e.name,fieldType:5,helpText:e.helpText,label:e.label,required:e.required}}function S(e){return{defaultValue:{fieldType:3,boolValue:e.defaultValue},disabled:e.disabled,fieldId:e.name,fieldType:3,helpText:e.helpText,label:e.label}}function h(e){return{fieldId:"",fieldType:6,fieldConfig:{groupConfig:{fields:p(e.fields)}},label:e.label,helpText:e.helpText}}var f=1,w=()=>(f++,`form.${f}`),c=async e=>{let t={fields:[],id:w(),title:e.title,acceptLabel:e.acceptLabel,cancelLabel:e.cancelLabel,shortDescription:e.description};a(e.fields),t.fields=p(e.fields);let o=await i({showForm:{form:t},type:3});if(!o||!o.formSubmitted)return{action:"CANCELED"};let r=m(o.formSubmitted.results);return{action:"SUBMITTED",values:r}};function u(e){let t;e instanceof Object?t={text:e.text,appearance:e.appearance==="success"?1:0}:t={text:e},i({showToast:{toast:t},type:4})}export{d as navigateTo,c as showForm,u as showToast};
+//# sourceMappingURL=client.min.js.map

package/client.min.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/effects/contants.ts", "../src/effects/emit-effect.ts", "../src/effects/navigate-to.ts", "../src/effects/helpers/assert-valid-form-fields.ts", "../src/effects/helpers/get-form-values.ts", "../src/effects/helpers/transform-form.ts", "../src/effects/show-form.ts", "../src/effects/show-toast.ts"],
+  "sourcesContent": ["import type { EffectType } from '@devvit/protos/types/devvit/ui/effects/v1alpha/effect.js';\n\nexport const EFFECTS_WITH_RESPONSE: readonly EffectType[] = [\n  3 satisfies EffectType.EFFECT_SHOW_FORM,\n];\n", "import type { Effect } from '@devvit/protos';\nimport type { WebViewInternalMessageScope } from '@devvit/protos/types/devvit/ui/effects/web_view/v1alpha/post_message.js';\nimport type { WebViewInternalEventMessage } from '@devvit/protos/types/devvit/ui/events/v1alpha/web_view.js';\n\nimport { EFFECTS_WITH_RESPONSE } from './contants.js';\nimport type { EmitEffectPayload } from './types.js';\n\n/**\n * Emits an effect to the parent window and handles the response if required.\n *\n * @param effect - The effect to be emitted to the parent window\n * @returns A promise that resolves with the response message for effects that require\n *          a response, or resolves immediately with undefined for effects that don't\n *\n * @description\n * This function handles two types of effects:\n * 1. Effects that require a response: Creates a unique ID, sets up a message listener,\n *    and resolves the promise when a matching response is received\n * 2. Effects that don't require a response: Posts the message and resolves immediately\n */\nexport const emitEffect = (effect: Effect): Promise<WebViewInternalEventMessage | undefined> => {\n  return new Promise<WebViewInternalEventMessage | undefined>((resolve) => {\n    const message: EmitEffectPayload = {\n      scope: 0 satisfies WebViewInternalMessageScope.CLIENT,\n      type: 'devvit-internal',\n      effect,\n    };\n\n    // Only set message id and add a listener for effects which require a response\n    if (EFFECTS_WITH_RESPONSE.includes(effect.type)) {\n      const id = self.crypto.randomUUID();\n      message.id = id;\n\n      const handleEffect = (event: MessageEvent): void => {\n        if (event.data?.type === 'devvit-message' && event.data?.data?.id === id) {\n          resolve(event.data.data as WebViewInternalEventMessage);\n          window.removeEventListener('message', handleEffect);\n        }\n      };\n\n      window.addEventListener('message', handleEffect);\n\n      // Post message to the parent window, handled by client web view component\n      window.parent.postMessage(message, '*');\n    } else {\n      window.parent.postMessage(message, '*');\n      // Resolve immediately for effects that don't expect a response.\n      resolve(undefined);\n    }\n  });\n};\n", "import type { EffectType } from '@devvit/protos/types/devvit/ui/effects/v1alpha/effect.js';\nimport type { Comment, Post, Subreddit, User } from '@devvit/public-api';\n\nimport { emitEffect } from './emit-effect.js';\n\n/**\n * Navigates to a URL, subreddit, post, comment, or user.\n *\n * @param thingOrUrl - The URL, subreddit, post, comment, or user to navigate to\n */\nexport function navigateTo(url: string): void;\nexport function navigateTo(subreddit: Subreddit): void;\nexport function navigateTo(post: Post): void;\nexport function navigateTo(comment: Comment): void;\nexport function navigateTo(user: User): void;\nexport function navigateTo(thingOrUrl: string | Subreddit | Post | Comment | User): void {\n  let url: string;\n\n  if (typeof thingOrUrl === 'string') {\n    // Validate URL\n    url = new URL(thingOrUrl).toString();\n  } else {\n    url = new URL(thingOrUrl.permalink, 'https://www.reddit.com').toString();\n  }\n\n  void emitEffect({\n    navigateToUrl: {\n      url,\n    },\n    type: 5 satisfies EffectType.EFFECT_NAVIGATE_TO_URL,\n  });\n}\n", "import type { FormField, SettingScope } from './form-types.js';\n\n/**\n * Make sure that the form fields have unique names.\n *\n * This is a carbon copy of the assertValidFormFields function in the public-api package\n * We copy it here so that @devvit/client does not need to depend on public-api\n * Any changes to this function should be reflected in the public-api version\n */\nexport function assertValidFormFields(\n  fields: readonly FormField[],\n  seenNames: Set<string> = new Set()\n): void {\n  for (const field of fields) {\n    if (field.type === 'group') {\n      assertValidFormFields(field.fields, seenNames);\n      continue;\n    }\n\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const fieldName = (field as any).name as string;\n\n    if (seenNames.has(fieldName)) {\n      throw new Error(`Duplicate field name: ${fieldName}`);\n    }\n\n    seenNames.add(fieldName);\n  }\n  assertAppSecretsOnly(fields);\n}\n\nexport function assertAppSecretsOnly(fields: readonly FormField[]): void {\n  for (const field of fields) {\n    if (field.type === 'string' && field.isSecret && field.scope !== ('app' as SettingScope.App)) {\n      throw `Invalid setting: only app settings can be secrets. Add \"scope: SettingScope.App\" to field \"${field.name}\"`;\n    }\n  }\n}\n", "import type { FormFieldType, FormFieldValue } from '@devvit/protos';\n\nimport type { FormValues } from './form-types.js';\n\nfunction flattenFormFieldValue(\n  value: FormFieldValue\n): undefined | string | string[] | number | boolean {\n  switch (value.fieldType) {\n    case 0 satisfies FormFieldType.STRING:\n      return value.stringValue;\n    case 7 satisfies FormFieldType.IMAGE:\n      // the string value is the URL\n      return value.stringValue;\n    case 1 satisfies FormFieldType.PARAGRAPH:\n      return value.stringValue;\n    case 2 satisfies FormFieldType.NUMBER:\n      return value.numberValue;\n    case 3 satisfies FormFieldType.BOOLEAN:\n      return value.boolValue;\n    case 5 satisfies FormFieldType.SELECTION:\n      return value.selectionValue?.values ?? [];\n    default:\n      return undefined;\n  }\n}\n\n// This is a carbon copy of the transformFormFields function in the public-api package\n// We copy it here so that @devvit/client does not need to depend on public-api\n// Any changes to this function should be reflected in the public-api version\nexport function getFormValues(results: { [key: string]: FormFieldValue }): FormValues {\n  return Object.keys(results).reduce((acc, key) => {\n    const val = flattenFormFieldValue(results[key]);\n    if (val !== undefined) acc[key] = val;\n    return acc;\n  }, {} as FormValues);\n}\n", "import type { FormField as FormFieldProto, FormFieldType } from '@devvit/protos';\n\nimport type {\n  BooleanField,\n  FormField,\n  FormFieldGroup,\n  ImageField,\n  NumberField,\n  ParagraphField,\n  SelectField,\n  StringField,\n} from './form-types.js';\n\n// This is a carbon copy of the transformFormFields function in the public-api package\n// We copy it here so that @devvit/client does not need to depend on public-api\n// Any changes to this function should be reflected in the public-api version\nexport function transformFormFields(fields: readonly FormField[]): FormFieldProto[] {\n  return fields.map((field) => {\n    switch (field.type) {\n      case 'string':\n        return transformStringField(field);\n      case 'image':\n        return transformImageField(field);\n      case 'paragraph':\n        return transformParagraphField(field);\n      case 'number':\n        return transformNumberField(field);\n      case 'select':\n        return transformSelectField(field);\n      case 'boolean':\n        return transformBooleanField(field);\n      case 'group':\n        return transformGroupField(field);\n      default:\n        throw new Error('Unknown field type.');\n    }\n  });\n}\n\nfunction transformStringField(field: StringField): FormFieldProto {\n  return {\n    defaultValue: {\n      fieldType: 0 satisfies FormFieldType.STRING,\n      stringValue: field.defaultValue,\n    },\n    disabled: field.disabled,\n    fieldConfig: {\n      stringConfig: {\n        placeholder: field.placeholder,\n      },\n    },\n    fieldId: field.name,\n    fieldType: 0 satisfies FormFieldType.STRING,\n    helpText: field.helpText,\n    label: field.label,\n    required: field.required,\n    isSecret: field.isSecret,\n  };\n}\n\nfunction transformImageField(field: ImageField): FormFieldProto {\n  return {\n    disabled: field.disabled,\n    fieldId: field.name,\n    fieldType: 7 satisfies FormFieldType.IMAGE,\n    helpText: field.helpText,\n    label: field.label,\n    required: field.required,\n  };\n}\n\nfunction transformParagraphField(field: ParagraphField): FormFieldProto {\n  return {\n    defaultValue: {\n      fieldType: 1 satisfies FormFieldType.PARAGRAPH,\n      stringValue: field.defaultValue,\n    },\n    disabled: field.disabled,\n    fieldConfig: {\n      paragraphConfig: {\n        lineHeight: field.lineHeight,\n        placeholder: field.placeholder,\n      },\n    },\n    fieldId: field.name,\n    fieldType: 1 satisfies FormFieldType.PARAGRAPH,\n    helpText: field.helpText,\n    label: field.label,\n    required: field.required,\n  };\n}\n\nfunction transformNumberField(field: NumberField): FormFieldProto {\n  return {\n    defaultValue: {\n      fieldType: 2 satisfies FormFieldType.NUMBER,\n      numberValue: field.defaultValue,\n    },\n    disabled: field.disabled,\n    fieldConfig: {\n      numberConfig: {},\n    },\n    fieldId: field.name,\n    fieldType: 2 satisfies FormFieldType.NUMBER,\n    helpText: field.helpText,\n    label: field.label,\n    required: field.required,\n  };\n}\n\nfunction transformSelectField(field: SelectField): FormFieldProto {\n  return {\n    defaultValue: {\n      fieldType: 5 satisfies FormFieldType.SELECTION,\n      selectionValue: {\n        values: field.defaultValue ?? [],\n      },\n    },\n    disabled: field.disabled,\n    fieldConfig: {\n      selectionConfig: {\n        choices: field.options,\n        multiSelect: field.multiSelect,\n      },\n    },\n    fieldId: field.name,\n    fieldType: 5 satisfies FormFieldType.SELECTION,\n    helpText: field.helpText,\n    label: field.label,\n    required: field.required,\n  };\n}\n\nfunction transformBooleanField(field: BooleanField): FormFieldProto {\n  return {\n    defaultValue: {\n      fieldType: 3 satisfies FormFieldType.BOOLEAN,\n      boolValue: field.defaultValue,\n    },\n    disabled: field.disabled,\n    fieldId: field.name,\n    fieldType: 3 satisfies FormFieldType.BOOLEAN,\n    helpText: field.helpText,\n    label: field.label,\n  };\n}\n\nfunction transformGroupField(field: FormFieldGroup): FormFieldProto {\n  return {\n    fieldId: '',\n    fieldType: 6 satisfies FormFieldType.GROUP,\n    fieldConfig: {\n      groupConfig: {\n        fields: transformFormFields(field.fields),\n      },\n    },\n    label: field.label,\n    helpText: field.helpText,\n  };\n}\n", "import type { Form as FormProto } from '@devvit/protos';\nimport type { EffectType } from '@devvit/protos/types/devvit/ui/effects/v1alpha/effect.js';\nimport type { Form, FormKey } from '@devvit/public-api';\n\nimport { emitEffect } from './emit-effect.js';\nimport { assertValidFormFields } from './helpers/assert-valid-form-fields.js';\nimport type { FormToFormValues } from './helpers/form-types.js';\nimport { getFormValues } from './helpers/get-form-values.js';\nimport { transformFormFields } from './helpers/transform-form.js';\nimport { FormAction, type FormEffectResponse } from './types.js';\n\nlet _formKey = 1;\n\nconst getNextFormKey = (): FormKey => {\n  _formKey++;\n  return `form.${_formKey}`;\n};\n\n/**\n * Opens a form in a modal.\n * Returns a promise that resolves with the form submission results.\n * The form can be submitted or canceled by the user.\n *\n * @param formDefinition - The form configuration\n * @returns A promise that resolves to either:\n *   - An object with `action: FormAction.SUBMITTED` and the submitted form values\n *   - An object with `action: FormAction.CANCELED` if the user canceled the form\n * @throws Will throw if the form fields are invalid\n */\nexport const showForm = async <const T extends Form>(\n  formDefinition: T\n): Promise<FormEffectResponse<FormToFormValues<T>>> => {\n  const form: FormProto = {\n    fields: [],\n    id: getNextFormKey(),\n    title: formDefinition.title,\n    acceptLabel: formDefinition.acceptLabel,\n    cancelLabel: formDefinition.cancelLabel,\n    shortDescription: formDefinition.description,\n  };\n\n  assertValidFormFields(formDefinition.fields);\n  form.fields = transformFormFields(formDefinition.fields);\n\n  const response = await emitEffect({\n    showForm: {\n      form,\n    },\n    type: 3 satisfies EffectType.EFFECT_SHOW_FORM,\n  });\n\n  if (!response || !response.formSubmitted) {\n    return {\n      action: FormAction.CANCELED,\n    };\n  }\n\n  const formResults = getFormValues(response.formSubmitted.results);\n\n  return {\n    action: FormAction.SUBMITTED,\n    values: formResults as FormToFormValues<T>,\n  };\n};\n", "import type { EffectType } from '@devvit/protos/types/devvit/ui/effects/v1alpha/effect.js';\nimport type {\n  Toast as ToastProto,\n  ToastAppearance,\n} from '@devvit/protos/types/devvit/ui/toast/toast.js';\nimport type { Toast } from '@devvit/public-api';\n\nimport { emitEffect } from './emit-effect.js';\n\n/**\n * Shows a toast message.\n *\n * @param textOrToast - The text or toast object to display\n */\nexport function showToast(text: string): void;\nexport function showToast(toast: Toast): void;\nexport function showToast(textOrToast: string | Toast): void {\n  let toast: ToastProto;\n\n  if (textOrToast instanceof Object) {\n    toast = {\n      text: textOrToast.text,\n      appearance:\n        textOrToast.appearance === 'success'\n          ? (1 satisfies ToastAppearance.SUCCESS)\n          : (0 satisfies ToastAppearance.NEUTRAL),\n    };\n  } else {\n    toast = {\n      text: textOrToast,\n    };\n  }\n\n  void emitEffect({\n    showToast: {\n      toast,\n    },\n    type: 4 satisfies EffectType.EFFECT_SHOW_TOAST,\n  });\n}\n"],
+  "mappings": "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",
+  "names": ["EFFECTS_WITH_RESPONSE", "emitEffect", "effect", "resolve", "message", "EFFECTS_WITH_RESPONSE", "id", "handleEffect", "event", "navigateTo", "thingOrUrl", "url", "emitEffect", "assertValidFormFields", "fields", "seenNames", "field", "fieldName", "assertAppSecretsOnly", "flattenFormFieldValue", "value", "getFormValues", "results", "acc", "key", "val", "transformFormFields", "fields", "field", "transformStringField", "transformImageField", "transformParagraphField", "transformNumberField", "transformSelectField", "transformBooleanField", "transformGroupField", "_formKey", "getNextFormKey", "showForm", "formDefinition", "form", "assertValidFormFields", "transformFormFields", "response", "emitEffect", "formResults", "getFormValues", "showToast", "textOrToast", "toast", "emitEffect"]
+}

package/effects/contants.d.ts

@@ -0,0 +1,3 @@
+import type { EffectType } from '@devvit/protos/types/devvit/ui/effects/v1alpha/effect.js';
+export declare const EFFECTS_WITH_RESPONSE: readonly EffectType[];
+//# sourceMappingURL=contants.d.ts.map

package/effects/contants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contants.d.ts","sourceRoot":"","sources":["../../src/effects/contants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0DAA0D,CAAC;AAE3F,eAAO,MAAM,qBAAqB,EAAE,SAAS,UAAU,EAEtD,CAAC"}

package/effects/contants.js

@@ -0,0 +1,3 @@
+export const EFFECTS_WITH_RESPONSE = [
+    3,
+];

package/effects/emit-effect.d.ts

@@ -0,0 +1,17 @@
+import type { Effect } from '@devvit/protos';
+import type { WebViewInternalEventMessage } from '@devvit/protos/types/devvit/ui/events/v1alpha/web_view.js';
+/**
+ * Emits an effect to the parent window and handles the response if required.
+ *
+ * @param effect - The effect to be emitted to the parent window
+ * @returns A promise that resolves with the response message for effects that require
+ *          a response, or resolves immediately with undefined for effects that don't
+ *
+ * @description
+ * This function handles two types of effects:
+ * 1. Effects that require a response: Creates a unique ID, sets up a message listener,
+ *    and resolves the promise when a matching response is received
+ * 2. Effects that don't require a response: Posts the message and resolves immediately
+ */
+export declare const emitEffect: (effect: Effect) => Promise<WebViewInternalEventMessage | undefined>;
+//# sourceMappingURL=emit-effect.d.ts.map

package/effects/emit-effect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-effect.d.ts","sourceRoot":"","sources":["../../src/effects/emit-effect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,2DAA2D,CAAC;AAK7G;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,UAAU,WAAY,MAAM,KAAG,QAAQ,2BAA2B,GAAG,SAAS,CA8B1F,CAAC"}

package/effects/emit-effect.js

@@ -0,0 +1,42 @@
+import { EFFECTS_WITH_RESPONSE } from './contants.js';
+/**
+ * Emits an effect to the parent window and handles the response if required.
+ *
+ * @param effect - The effect to be emitted to the parent window
+ * @returns A promise that resolves with the response message for effects that require
+ *          a response, or resolves immediately with undefined for effects that don't
+ *
+ * @description
+ * This function handles two types of effects:
+ * 1. Effects that require a response: Creates a unique ID, sets up a message listener,
+ *    and resolves the promise when a matching response is received
+ * 2. Effects that don't require a response: Posts the message and resolves immediately
+ */
+export const emitEffect = (effect) => {
+    return new Promise((resolve) => {
+        const message = {
+            scope: 0,
+            type: 'devvit-internal',
+            effect,
+        };
+        // Only set message id and add a listener for effects which require a response
+        if (EFFECTS_WITH_RESPONSE.includes(effect.type)) {
+            const id = self.crypto.randomUUID();
+            message.id = id;
+            const handleEffect = (event) => {
+                if (event.data?.type === 'devvit-message' && event.data?.data?.id === id) {
+                    resolve(event.data.data);
+                    window.removeEventListener('message', handleEffect);
+                }
+            };
+            window.addEventListener('message', handleEffect);
+            // Post message to the parent window, handled by client web view component
+            window.parent.postMessage(message, '*');
+        }
+        else {
+            window.parent.postMessage(message, '*');
+            // Resolve immediately for effects that don't expect a response.
+            resolve(undefined);
+        }
+    });
+};

package/effects/emit-effect.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-effect.test.d.ts","sourceRoot":"","sources":["../../src/effects/emit-effect.test.ts"],"names":[],"mappings":""}

package/effects/helpers/assert-valid-form-fields.d.ts

@@ -0,0 +1,11 @@
+import type { FormField } from './form-types.js';
+/**
+ * Make sure that the form fields have unique names.
+ *
+ * This is a carbon copy of the assertValidFormFields function in the public-api package
+ * We copy it here so that @devvit/client does not need to depend on public-api
+ * Any changes to this function should be reflected in the public-api version
+ */
+export declare function assertValidFormFields(fields: readonly FormField[], seenNames?: Set<string>): void;
+export declare function assertAppSecretsOnly(fields: readonly FormField[]): void;
+//# sourceMappingURL=assert-valid-form-fields.d.ts.map

package/effects/helpers/assert-valid-form-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert-valid-form-fields.d.ts","sourceRoot":"","sources":["../../../src/effects/helpers/assert-valid-form-fields.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAgB,MAAM,iBAAiB,CAAC;AAE/D;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,SAAS,EAAE,EAC5B,SAAS,GAAE,GAAG,CAAC,MAAM,CAAa,GACjC,IAAI,CAiBN;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,GAAG,IAAI,CAMvE"}

package/effects/helpers/assert-valid-form-fields.js

@@ -0,0 +1,29 @@
+/**
+ * Make sure that the form fields have unique names.
+ *
+ * This is a carbon copy of the assertValidFormFields function in the public-api package
+ * We copy it here so that @devvit/client does not need to depend on public-api
+ * Any changes to this function should be reflected in the public-api version
+ */
+export function assertValidFormFields(fields, seenNames = new Set()) {
+    for (const field of fields) {
+        if (field.type === 'group') {
+            assertValidFormFields(field.fields, seenNames);
+            continue;
+        }
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const fieldName = field.name;
+        if (seenNames.has(fieldName)) {
+            throw new Error(`Duplicate field name: ${fieldName}`);
+        }
+        seenNames.add(fieldName);
+    }
+    assertAppSecretsOnly(fields);
+}
+export function assertAppSecretsOnly(fields) {
+    for (const field of fields) {
+        if (field.type === 'string' && field.isSecret && field.scope !== 'app') {
+            throw `Invalid setting: only app settings can be secrets. Add "scope: SettingScope.App" to field "${field.name}"`;
+        }
+    }
+}

package/effects/helpers/assert-valid-form-fields.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert-valid-form-fields.test.d.ts","sourceRoot":"","sources":["../../../src/effects/helpers/assert-valid-form-fields.test.ts"],"names":[],"mappings":""}

package/effects/helpers/form-types.d.ts

@@ -0,0 +1,149 @@
+import type { FieldConfig_Boolean, FieldConfig_Number, FieldConfig_Paragraph, FieldConfig_Selection, FieldConfig_Selection_Item, FieldConfig_String } from '@devvit/protos';
+type Prettify<T> = {
+    [K in keyof T]: T[K];
+};
+type JSONValue = JSONPrimitive | JSONArray | JSONObject;
+type JSONObject = {
+    [key: string]: JSONValue;
+};
+type JSONArray = JSONValue[];
+type JSONPrimitive = boolean | null | number | string;
+export type FormValues = JSONObject;
+export type BaseField<ValueType> = {
+    /**
+     * The name of the field. This will be used as the key in the `values` object
+     * when the form is submitted.
+     */
+    name: string;
+    /** The label of the field. This will be displayed to the user */
+    label: string;
+    /** An optional help text that will be displayed below the field */
+    helpText?: string | undefined;
+    /**
+     * If true the field will be required and the user will not be able to submit
+     * the form without filling it in.
+     */
+    required?: boolean | undefined;
+    /** If true the field will be disabled */
+    disabled?: boolean | undefined;
+    /** The default value of the field */
+    defaultValue?: ValueType | undefined;
+    /**
+     * This indicates whether the field (setting) is an app level or install level
+     * setting. App setting values can be used by any installation.
+     */
+    scope?: SettingScopeType | undefined;
+};
+export type SettingScopeType = 'installation' | 'app';
+export declare enum SettingScope {
+    Installation = "installation",
+    App = "app"
+}
+/** A text field */
+export type StringField = Prettify<BaseField<string> & Omit<FieldConfig_String, 'minLength' | 'maxLength'> & {
+    type: 'string';
+    isSecret?: boolean;
+}>;
+/**
+ * Allows a user to upload an image as part of submitting the form. The string value that's
+ * given back is the URL of the image.
+ * @experimental
+ */
+export type ImageField = Omit<BaseField<string>, 'defaultValue'> & {
+    type: 'image';
+};
+/** A paragraph or textarea field */
+export type ParagraphField = Prettify<BaseField<string> & Omit<FieldConfig_Paragraph, 'maxCharacters'> & {
+    type: 'paragraph';
+}>;
+/** A number field */
+export type NumberField = Prettify<BaseField<number> & Omit<FieldConfig_Number, 'min' | 'max' | 'step'> & {
+    type: 'number';
+}>;
+/** A boolean field displayed as a toggle */
+export type BooleanField = Prettify<Omit<BaseField<boolean>, 'required'> & FieldConfig_Boolean & {
+    type: 'boolean';
+}>;
+/** A dropdown field that allows users to pick from a list of options */
+export type SelectField = Prettify<BaseField<string[]> & Omit<FieldConfig_Selection, 'choices' | 'renderAsList' | 'minSelections' | 'maxSelections'> & {
+    type: 'select';
+    options: FieldConfig_Selection_Item[];
+}>;
+/** A grouping of fields */
+export type FormFieldGroup = {
+    type: 'group';
+    /** The label of the group that will be displayed to the user */
+    label: string;
+    /** The fields that will be displayed in the group */
+    fields: readonly FormField[];
+    /** An optional help text that will be displayed below the group */
+    helpText?: string | undefined;
+    required?: never;
+};
+export type FormField = StringField | ImageField | ParagraphField | NumberField | BooleanField | SelectField | FormFieldGroup;
+export type Form = {
+    /** The fields that will be displayed in the form */
+    fields: readonly FormField[];
+    /** An optional title for the form */
+    title?: string;
+    /** An optional description for the form */
+    description?: string;
+    /** An optional label for the submit button */
+    acceptLabel?: string;
+    /** An optional label for the cancel button */
+    cancelLabel?: string;
+};
+/**
+ * A function that returns a form. You can use this to dynamically generate a form.
+ * @example
+ * ```ts
+ * const formKey = Devvit.createForm((data) => ({
+ *   fields: data.fields,
+ *   title: data.title,
+ * }), callback);
+ *
+ * ...
+ *
+ * ui.showForm(formKey, {
+ *  fields: [{ type: 'string', name: 'title', label: 'Title' }]
+ *  title: 'My dynamic form'
+ * });
+ * ```
+ * */
+export type FormFunction<T extends {
+    [key: string]: any;
+} = {
+    [key: string]: any;
+}> = (data: T) => Form;
+export type FormToFormValues<T extends Form | FormFunction = Form | FormFunction> = FormFieldsToFormValues<(T extends FormFunction ? ReturnType<T> : T)['fields']>;
+/**
+ * Input is a FormField[], output is a
+ * {fieldNameA: fieldTypeA, fieldNameB: fieldTypeB}.
+ */
+type FormFieldsToFormValues<T extends readonly FormField[]> = T extends readonly [
+    infer Field extends FormField,
+    ...infer Rest extends FormField[]
+] ? FormFieldToFormValue<Field> & FormFieldsToFormValues<Rest> : {
+    [key: string]: any;
+};
+/** Input is a FormField, output is a {fieldName: fieldType}. */
+type FormFieldToFormValue<T extends FormField> = T extends BooleanField ? {
+    [_ in T['name']]: boolean;
+} : T extends ImageField | ParagraphField | StringField ? FormFieldToRequiredFormValue<T, string> : T extends NumberField ? FormFieldToRequiredFormValue<T, number> : T extends SelectField ? {
+    [_ in T['name']]: string[];
+} : T extends FormFieldGroup ? FormFieldsToFormValues<T['fields']> : never;
+/**
+ * Input is a FormField, output is a {fieldName: fieldType} or
+ * {fieldName?: fieldType}.
+ */
+type FormFieldToRequiredFormValue<T extends ImageField | ParagraphField | StringField | NumberField, V> = T extends {
+    required: true;
+} | {
+    defaultValue: boolean | number | string;
+} ? {
+    [_ in T['name']]: V;
+} : {
+    [_ in T['name']]?: V;
+};
+export {};
+//# sourceMappingURL=form-types.d.ts.map

package/effects/helpers/form-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-types.d.ts","sourceRoot":"","sources":["../../../src/effects/helpers/form-types.ts"],"names":[],"mappings":"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"}

package/effects/helpers/form-types.js

@@ -0,0 +1,5 @@
+export var SettingScope;
+(function (SettingScope) {
+    SettingScope["Installation"] = "installation";
+    SettingScope["App"] = "app";
+})(SettingScope || (SettingScope = {}));

package/effects/helpers/get-form-values.d.ts

@@ -0,0 +1,6 @@
+import type { FormFieldValue } from '@devvit/protos';
+import type { FormValues } from './form-types.js';
+export declare function getFormValues(results: {
+    [key: string]: FormFieldValue;
+}): FormValues;
+//# sourceMappingURL=get-form-values.d.ts.map

package/effects/helpers/get-form-values.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-form-values.d.ts","sourceRoot":"","sources":["../../../src/effects/helpers/get-form-values.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AA2BlD,wBAAgB,aAAa,CAAC,OAAO,EAAE;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAAA;CAAE,GAAG,UAAU,CAMpF"}

package/effects/helpers/get-form-values.js

@@ -0,0 +1,30 @@
+function flattenFormFieldValue(value) {
+    switch (value.fieldType) {
+        case 0:
+            return value.stringValue;
+        case 7:
+            // the string value is the URL
+            return value.stringValue;
+        case 1:
+            return value.stringValue;
+        case 2:
+            return value.numberValue;
+        case 3:
+            return value.boolValue;
+        case 5:
+            return value.selectionValue?.values ?? [];
+        default:
+            return undefined;
+    }
+}
+// This is a carbon copy of the transformFormFields function in the public-api package
+// We copy it here so that @devvit/client does not need to depend on public-api
+// Any changes to this function should be reflected in the public-api version
+export function getFormValues(results) {
+    return Object.keys(results).reduce((acc, key) => {
+        const val = flattenFormFieldValue(results[key]);
+        if (val !== undefined)
+            acc[key] = val;
+        return acc;
+    }, {});
+}

package/effects/helpers/get-form-values.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-form-values.test.d.ts","sourceRoot":"","sources":["../../../src/effects/helpers/get-form-values.test.ts"],"names":[],"mappings":""}

package/effects/helpers/test-helpers.d.ts

@@ -0,0 +1,10 @@
+import type { Effect } from '@devvit/protos/types/devvit/ui/effects/v1alpha/effect.js';
+import type { Comment, Form, Post, Subreddit, User } from '@devvit/public-api';
+export declare const mockSubreddit: Readonly<Subreddit>;
+export declare const mockPost: Readonly<Post>;
+export declare const mockComment: Readonly<Comment>;
+export declare const mockUser: Readonly<User>;
+export declare const basicFormDefinition: Readonly<Form>;
+export declare const complexFormDefinition: Readonly<Form>;
+export declare const expectedShowFormMessage: (form: Readonly<Form>) => Effect;
+//# sourceMappingURL=test-helpers.d.ts.map

package/effects/helpers/test-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-helpers.d.ts","sourceRoot":"","sources":["../../../src/effects/helpers/test-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAc,MAAM,0DAA0D,CAAC;AACnG,OAAO,KAAK,EACV,OAAO,EACP,IAAI,EAEJ,IAAI,EAGJ,SAAS,EACT,IAAI,EACL,MAAM,oBAAoB,CAAC;AAI5B,eAAO,MAAM,aAAa,qBAmDkB,CAAC;AAE7C,eAAO,MAAM,QAAQ,gBAkCS,CAAC;AAE/B,eAAO,MAAM,WAAW,mBAyBS,CAAC;AAElC,eAAO,MAAM,QAAQ,gBAYS,CAAC;AAI/B,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,IAAI,CAY9C,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,IAAI,CA2BhD,CAAC;AAEF,eAAO,MAAM,uBAAuB,SAAU,SAAS,IAAI,CAAC,KAAG,MAyF7D,CAAC"}