@rvoh/dream 2.36.1 → 2.38.0

package/dist/types/src/serializer/builders/DreamSerializerBuilder.d.ts

@@ -146,8 +146,21 @@ export default class DreamSerializerBuilder<DataTypeForOpenapi extends typeof Dr
      *     property bodies (`type: 'object'`, `properties`, and `required` listing the keys that
      *     are always present), or `{ $serializer: SomeSerializer }` when the callback returns
      *     what that serializer renders. A serializer ref with `many: true` does not type-check
-     *     here, since a list has no properties to spread. A `null` or `undefined` return adds no
-     *     keys. Attributes render in declaration order, so a key the returned object shares with
+     *     here, since a list has no properties to spread. A `null` return, a serializer built over
+     *     `null` or `undefined` data, or an `undefined` return without `required: false` renders as
+     *     `null` each key the `openapi` requires: a key an object shape lists in its `required`
+     *     array, a key a `$serializer` or `$serializable` ref's serializer declares without
+     *     `required: false`, and each such key of an `allOf`, `anyOf` or `oneOf` member. Its
+     *     optional keys stay absent, and an `undefined` return with `required: false` adds no keys.
+     *     A returned plain object also renders as `null` each key its shape requires that it
+     *     leaves out, and its optional keys it leaves out stay absent. When the `openapi` is an
+     *     `anyOf` or `oneOf`, or a `$serializable` ref to an STI base, a present value also renders
+     *     as `null` each key another variant requires that the rendered one does not declare, so a
+     *     client sees the same keys whichever variant is rendered.
+     *     Every key it adds follows the render's casing like the parent's own keys: a returned
+     *     plain object's top-level keys and the `openapi`'s `properties` keys are cased (so
+     *     `casing: 'snake'` renders `phoneNumber` as `phone_number`, present or `null`), while
+     *     nested values render as returned. Attributes render in declaration order, so a key the returned object shares with
      *     another attribute takes the value of whichever is declared later; under the `allOf`,
      *     that value must match both schemas
      *   - `required` - Set to `false` to mark the attribute as optional in the OpenAPI schema;
@@ -191,14 +204,23 @@ export default class DreamSerializerBuilder<DataTypeForOpenapi extends typeof Dr
      *     declaration order, so when the parent and the association share a key (e.g., `id`),
      *     whichever is declared later wins: the association's value replaces an attribute declared
      *     before the `rendersOne`, and an attribute declared after it replaces the association's.
-     *     When the association is `null`, every key its serializer declares renders as `null`
-     *     (for a polymorphic `BelongsTo`, every key the serializer of any of its target classes
-     *     declares, and for an association to an STI base, every key the serializer of any of its
-     *     STI children declares), in the same order (so an `id` declared before the `rendersOne` becomes
-     *     `null`); nothing in that serializer is rendered, so its custom attribute callbacks do
-     *     not run, and a flattened `customAttribute` in it adds no keys. Psychic adds the association's OpenAPI
-     *     schema to the parent's as an `allOf` branch, so a shared key's value must match both
-     *     schemas, whichever declaration wins
+     *     When the association is `null`, each key its serializer requires renders as `null`: an
+     *     attribute, delegatedAttribute or customAttribute declared without `required: false`, and
+     *     every non-flattened `rendersOne` and `rendersMany` (for a polymorphic `BelongsTo`, each
+     *     key the serializer of any of its target classes requires, and for an association to an
+     *     STI base, each key the serializer of any of its STI children requires), in the same order
+     *     (so an `id` declared before the `rendersOne` becomes `null`), while a key declared with
+     *     `required: false` stays absent. A flattened `customAttribute` in that serializer adds the
+     *     keys its `openapi` requires: a key an object shape lists in its `required` array, a key a
+     *     `$serializer` or `$serializable` ref's serializer declares without `required: false`, and
+     *     each such key of an `allOf`, `anyOf` or `oneOf` member; a ref with `many: true` adds none,
+     *     and a flattened `customAttribute` declared with `required: false` adds none. Nothing in
+     *     that serializer is rendered, so its custom attribute callbacks do not run. When the
+     *     association to an STI base or polymorphic `BelongsTo` is present, each key another STI
+     *     child's or target's serializer requires that the held one's serializer does not declare
+     *     also renders as `null`, so a client sees the same keys whichever is held. Psychic adds
+     *     the association's OpenAPI schema to the parent's as an `allOf` branch, so a shared key's
+     *     value must match both schemas, whichever declaration wins
      *   - `optional` - When `true`, allows the association to be null/missing without causing
      *     an `OpenapiResponseValidationFailure` during Psychic controller unit specs. By default,
      *     `rendersOne` expects the association to be present (mirroring the `optional` option on
@@ -254,8 +276,8 @@ export default class DreamSerializerBuilder<DataTypeForOpenapi extends typeof Dr
          * If `true`, the rendered association's attributes are merged directly into
          * the parent object instead of being nested under the association key. A key
          * the parent shares with the association takes the value of whichever is
-         * declared later, and when the association is `null`, every key its serializer
-         * declares renders as `null`. See the `flatten` option of `rendersOne`.
+         * declared later, and when the association is `null`, each key its serializer
+         * requires renders as `null`. See the `flatten` option of `rendersOne`.
          */
         flatten?: boolean;
         /**

package/dist/types/src/serializer/builders/ObjectSerializerBuilder.d.ts

@@ -139,8 +139,21 @@ export default class ObjectSerializerBuilder<MaybeNullDataType extends object |
      *     property bodies (`type: 'object'`, `properties`, and `required` listing the keys that
      *     are always present), or `{ $serializer: SomeSerializer }` when the callback returns
      *     what that serializer renders. A serializer ref with `many: true` does not type-check
-     *     here, since a list has no properties to spread. A `null` or `undefined` return adds no
-     *     keys. Attributes render in declaration order, so a key the returned object shares with
+     *     here, since a list has no properties to spread. A `null` return, a serializer built over
+     *     `null` or `undefined` data, or an `undefined` return without `required: false` renders as
+     *     `null` each key the `openapi` requires: a key an object shape lists in its `required`
+     *     array, a key a `$serializer` or `$serializable` ref's serializer declares without
+     *     `required: false`, and each such key of an `allOf`, `anyOf` or `oneOf` member. Its
+     *     optional keys stay absent, and an `undefined` return with `required: false` adds no keys.
+     *     A returned plain object also renders as `null` each key its shape requires that it
+     *     leaves out, and its optional keys it leaves out stay absent. When the `openapi` is an
+     *     `anyOf` or `oneOf`, or a `$serializable` ref to an STI base, a present value also renders
+     *     as `null` each key another variant requires that the rendered one does not declare, so a
+     *     client sees the same keys whichever variant is rendered.
+     *     Every key it adds follows the render's casing like the parent's own keys: a returned
+     *     plain object's top-level keys and the `openapi`'s `properties` keys are cased (so
+     *     `casing: 'snake'` renders `phoneNumber` as `phone_number`, present or `null`), while
+     *     nested values render as returned. Attributes render in declaration order, so a key the returned object shares with
      *     another attribute takes the value of whichever is declared later; under the `allOf`,
      *     that value must match both schemas
      *   - `required` - Set to `false` to mark the attribute as optional in the OpenAPI schema;
@@ -184,14 +197,23 @@ export default class ObjectSerializerBuilder<MaybeNullDataType extends object |
      *     declaration order, so when the parent and the association share a key (e.g., `id`),
      *     whichever is declared later wins: the association's value replaces an attribute declared
      *     before the `rendersOne`, and an attribute declared after it replaces the association's.
-     *     When the association is `null`, every key its serializer declares renders as `null`
-     *     (for a polymorphic `BelongsTo`, every key the serializer of any of its target classes
-     *     declares, and for an association to an STI base, every key the serializer of any of its
-     *     STI children declares), in the same order (so an `id` declared before the `rendersOne` becomes
-     *     `null`); nothing in that serializer is rendered, so its custom attribute callbacks do
-     *     not run, and a flattened `customAttribute` in it adds no keys. Psychic adds the association's OpenAPI
-     *     schema to the parent's as an `allOf` branch, so a shared key's value must match both
-     *     schemas, whichever declaration wins
+     *     When the association is `null`, each key its serializer requires renders as `null`: an
+     *     attribute, delegatedAttribute or customAttribute declared without `required: false`, and
+     *     every non-flattened `rendersOne` and `rendersMany` (for a polymorphic `BelongsTo`, each
+     *     key the serializer of any of its target classes requires, and for an association to an
+     *     STI base, each key the serializer of any of its STI children requires), in the same order
+     *     (so an `id` declared before the `rendersOne` becomes `null`), while a key declared with
+     *     `required: false` stays absent. A flattened `customAttribute` in that serializer adds the
+     *     keys its `openapi` requires: a key an object shape lists in its `required` array, a key a
+     *     `$serializer` or `$serializable` ref's serializer declares without `required: false`, and
+     *     each such key of an `allOf`, `anyOf` or `oneOf` member; a ref with `many: true` adds none,
+     *     and a flattened `customAttribute` declared with `required: false` adds none. Nothing in
+     *     that serializer is rendered, so its custom attribute callbacks do not run. When the
+     *     association to an STI base or polymorphic `BelongsTo` is present, each key another STI
+     *     child's or target's serializer requires that the held one's serializer does not declare
+     *     also renders as `null`, so a client sees the same keys whichever is held. Psychic adds
+     *     the association's OpenAPI schema to the parent's as an `allOf` branch, so a shared key's
+     *     value must match both schemas, whichever declaration wins
      *   - `optional` - When `true`, allows the association to be null/missing without causing
      *     an `OpenapiResponseValidationFailure` during Psychic controller unit specs. By default,
      *     `rendersOne` expects the association to be present (mirroring the `optional` option on
@@ -249,8 +271,8 @@ export default class ObjectSerializerBuilder<MaybeNullDataType extends object |
          * If `true`, the rendered association's attributes are merged directly into
          * the parent object instead of being nested under the association key. A key
          * the parent shares with the association takes the value of whichever is
-         * declared later, and when the association is `null`, every key its serializer
-         * declares renders as `null`. See the `flatten` option of `rendersOne`.
+         * declared later, and when the association is `null`, each key its serializer
+         * requires renders as `null`. See the `flatten` option of `rendersOne`.
          */
         flatten?: boolean;
         /**

package/dist/types/src/serializer/helpers/nullFlattenedSerializerKeys.d.ts

@@ -0,0 +1,75 @@
+import { OpenapiSchemaBodyShorthand, OpenapiShorthandPrimitiveTypes } from '../../types/openapi.js';
+import { DreamModelSerializerType, SerializerCasing, SimpleObjectSerializerType } from '../../types/serializer.js';
+export interface NullFlattenedSerializerKeysOptions {
+    casing?: SerializerCasing;
+    passthroughData?: object;
+}
+/**
+ * The keys a flattened `rendersOne` adds to the parent's payload when its associated object is
+ * null, returned as an object with each key set to `null`, ready to spread into the parent's
+ * payload (`Object.keys` of it for the key names alone): each key one of `serializers` requires.
+ * As a property read on an empty object is `undefined`, a null value carries no key it may omit:
+ * an attribute, delegatedAttribute or customAttribute declared with `required: false` adds no key.
+ * Every key is cased per `casing`, as the renderer cases it. There are several serializers when
+ * the association is a polymorphic BelongsTo, one for each target class, or when the associated
+ * class is an STI base, one for each child, and their required keys are unioned.
+ *
+ * Each serializer is built with `undefined` data to read its declarations, as Psychic's OpenAPI
+ * generation and `preloadFor` build it, and nothing is rendered: no attribute callback runs and
+ * no association of the missing object is read. A non-flattened `rendersOne` or a `rendersMany`
+ * always adds its key. A flattened `rendersOne` it declares adds its own serializers' required keys
+ * the same way. A flattened `customAttribute` adds the keys its `openapi` requires: each key of
+ * its `properties` that the shape's `required` array lists, the required keys of the serializer a
+ * `$serializer` ref names or of every serializer a `$serializable` ref resolves to (one per child
+ * for an STI base), walked the same way, and the union of the keys every member of an `allOf`,
+ * `anyOf` or `oneOf` requires, with each key an object shape's own `required` array lists beside
+ * its members; one declared with `required: false` adds none. A ref with `many: true` adds none,
+ * since a list has no keys to spread. A serializer reached again within its own walk, as when one
+ * flattens itself, adds nothing, so the walk always terminates; one reached again along another
+ * path is walked again, so each path adds its keys and their requirements.
+ *
+ * `passthroughData` is handed to each serializer as it is built, as when rendering; outside a
+ * render it may be left out.
+ */
+export declare function nullFlattenedSerializerKeys(serializers: (DreamModelSerializerType | SimpleObjectSerializerType)[], options?: NullFlattenedSerializerKeysOptions): Record<string, null>;
+/**
+ * The keys a flattened `customAttribute` with this `openapi` adds to the parent's payload when
+ * its callback returns null (or `undefined` without `required: false`), or a serializer built over
+ * null data, each set to `null`: each key `openapi` requires, walked as `nullFlattenedSerializerKeys`
+ * walks a flattened `customAttribute` and cased per `casing`.
+ */
+export declare function nullFlattenedOpenapiKeys(openapi: OpenapiSchemaBodyShorthand | OpenapiShorthandPrimitiveTypes, options?: NullFlattenedSerializerKeysOptions): Record<string, null>;
+/**
+ * The keys a present flattened `rendersOne` adds to the parent's payload, each set to `null`,
+ * beside what `renderedSerializer` renders: each key one of `serializers` (every serializer the
+ * association may render with) requires that `renderedSerializer` does not declare at all. A key
+ * `renderedSerializer` declares is its own to render or, when `required: false`, to omit.
+ */
+export declare function nullFlattenedSerializerKeysOfOtherVariants(serializers: (DreamModelSerializerType | SimpleObjectSerializerType)[], renderedSerializer: DreamModelSerializerType | SimpleObjectSerializerType, options?: NullFlattenedSerializerKeysOptions): Record<string, null>;
+/**
+ * The keys a flattened `customAttribute` with this `openapi` adds to the parent's payload, each
+ * set to `null`, when it renders `renderedVariant`: each key a variant of `openapi` requires that
+ * `renderedVariant` does not declare. `renderedVariant` is any `openapi` shorthand: one member of
+ * an `anyOf` or `oneOf`, or `{ $serializer: childSerializer }` for one child of a `$serializable`
+ * ref to an STI base. A key requires its value when an object shape's `required` array lists it,
+ * whether the shape's own `properties` declare it or a member of its `allOf`, `anyOf` or `oneOf`
+ * does, or when a serializer declares it without `required: false`.
+ */
+export declare function nullFlattenedOpenapiKeysOfOtherVariants(openapi: OpenapiSchemaBodyShorthand | OpenapiShorthandPrimitiveTypes, renderedVariant: OpenapiSchemaBodyShorthand | OpenapiShorthandPrimitiveTypes, options?: NullFlattenedSerializerKeysOptions): Record<string, null>;
+/**
+ * The keys a flattened `customAttribute` with this `openapi` adds to the parent's payload, each
+ * set to `null`, beside the non-null `value` its callback returned, from which the rendered
+ * variant is read. A serializer's declarations are the rendered variant, so a `$serializable` ref
+ * to an STI base adds the keys of every other child, as `nullFlattenedOpenapiKeysOfOtherVariants`
+ * reads them; the serializer renders each of its own keys. A plain object renders only the keys
+ * it has, so it adds each key the rendered variant requires that the object leaves out as well as
+ * each key another variant requires that the rendered one does not declare. An `openapi` with one
+ * variant is the rendered one. Of several variants (the members of an `anyOf` or `oneOf`, or one
+ * `$serializer` per child of a `$serializable` ref to an STI base, a member with several variants
+ * of its own contributing each of them, and an `allOf` beside an `anyOf` or `oneOf` joining each
+ * of its variants), the rendered one is the variant that declares every key the object has; when
+ * several do, the first of them whose required keys the object all has, and when none is found,
+ * the object adds each key any variant requires. The object's top-level keys render cased per
+ * `casing`, so they are compared cased, and a key it has is never added.
+ */
+export declare function nullFlattenedOpenapiKeysForValue(openapi: OpenapiSchemaBodyShorthand | OpenapiShorthandPrimitiveTypes, value: unknown, options?: NullFlattenedSerializerKeysOptions): Record<string, null>;

package/dist/types/src/types/db.d.ts

@@ -9,4 +9,75 @@ export type NonArrayDbTypes = (typeof postgresDatatypes)[number];
 export type DbTypes = NonArrayDbTypes | `${NonArrayDbTypes}[]`;
 export type PrimaryKeyType = (typeof primaryKeyTypes)[number];
 export type LegacyCompatiblePrimaryKeyType = PrimaryKeyType | 'uuid' | 'bigserial';
+/**
+ * A connection's tables and enums, as a query driver's `introspectDatabase`
+ * reads them. `sync` writes both of a connection's types files from it:
+ * `types/db.ts`, which types the connection's Kysely queries, and
+ * `types/dream.ts`, Dream's schema.
+ */
+export interface IntrospectedDatabase {
+    tables: IntrospectedTable[];
+    enums: IntrospectedEnum[];
+}
+export interface IntrospectedTable {
+    /**
+     * The table's schema, e.g. `public`, or `null` for a database without
+     * schemas. A table pattern that contains a `.` is matched against
+     * `<schema>.<name>` (see `tableIncludePattern`).
+     */
+    schema: string | null;
+    /**
+     * The table's name, e.g. `balloon_lines`.
+     */
+    name: string;
+    /**
+     * Whether the table is in the connection's default schema. Kysely queries
+     * name such a table alone, and any other as `<schema>.<name>`.
+     */
+    inDefaultSchema: boolean;
+    columns: IntrospectedColumn[];
+}
+export interface IntrospectedColumn {
+    /**
+     * The column's name, e.g. `created_at`.
+     */
+    name: string;
+    /**
+     * The column's database type as Dream's schema records it, e.g. `bigint`,
+     * `timestamp without time zone[]`, or an enum's name.
+     */
+    dbType: string;
+    /**
+     * The type of one of the column's values in `types/db.ts`, or `'enum'`
+     * when the values are those of `enumName`.
+     */
+    valueType: IntrospectedValueType;
+    /**
+     * The name of the enum the column's values belong to, or `null`. An enum
+     * outside the connection's default schema is named `<schema>.<name>`.
+     */
+    enumName: string | null;
+    isArray: boolean;
+    allowNull: boolean;
+    /**
+     * Whether an insert may leave the column out: it has a default, or the
+     * database generates its values.
+     */
+    hasDefault: boolean;
+}
+export interface IntrospectedEnum {
+    /**
+     * The enum's name, as columns' `enumName` gives it, e.g.
+     * `balloon_colors_enum`.
+     */
+    name: string;
+    values: string[];
+}
+/**
+ * The types `types/db.ts` can give one value of a column. `Int8`, `Numeric`,
+ * `Timestamp` (a `DateTime` or `CalendarDate`), `Json`, `Interval`, `Point`
+ * and `Circle` are declared in that file; `Date` and `Buffer` are
+ * JavaScript's.
+ */
+export type IntrospectedValueType = 'string' | 'number' | 'boolean' | 'Int8' | 'Numeric' | 'Timestamp' | 'Date' | 'ClockTime' | 'ClockTimeTz' | 'Json' | 'Buffer' | 'Interval' | 'Point' | 'Circle' | 'enum';
 export {};

package/dist/types/src/types/types/db.ts

@@ -15,3 +15,94 @@ export type NonArrayDbTypes = (typeof postgresDatatypes)[number]
 export type DbTypes = NonArrayDbTypes | `${NonArrayDbTypes}[]`
 export type PrimaryKeyType = (typeof primaryKeyTypes)[number]
 export type LegacyCompatiblePrimaryKeyType = PrimaryKeyType | 'uuid' | 'bigserial'
+
+/**
+ * A connection's tables and enums, as a query driver's `introspectDatabase`
+ * reads them. `sync` writes both of a connection's types files from it:
+ * `types/db.ts`, which types the connection's Kysely queries, and
+ * `types/dream.ts`, Dream's schema.
+ */
+export interface IntrospectedDatabase {
+  tables: IntrospectedTable[]
+  enums: IntrospectedEnum[]
+}
+
+export interface IntrospectedTable {
+  /**
+   * The table's schema, e.g. `public`, or `null` for a database without
+   * schemas. A table pattern that contains a `.` is matched against
+   * `<schema>.<name>` (see `tableIncludePattern`).
+   */
+  schema: string | null
+  /**
+   * The table's name, e.g. `balloon_lines`.
+   */
+  name: string
+  /**
+   * Whether the table is in the connection's default schema. Kysely queries
+   * name such a table alone, and any other as `<schema>.<name>`.
+   */
+  inDefaultSchema: boolean
+  columns: IntrospectedColumn[]
+}
+
+export interface IntrospectedColumn {
+  /**
+   * The column's name, e.g. `created_at`.
+   */
+  name: string
+  /**
+   * The column's database type as Dream's schema records it, e.g. `bigint`,
+   * `timestamp without time zone[]`, or an enum's name.
+   */
+  dbType: string
+  /**
+   * The type of one of the column's values in `types/db.ts`, or `'enum'`
+   * when the values are those of `enumName`.
+   */
+  valueType: IntrospectedValueType
+  /**
+   * The name of the enum the column's values belong to, or `null`. An enum
+   * outside the connection's default schema is named `<schema>.<name>`.
+   */
+  enumName: string | null
+  isArray: boolean
+  allowNull: boolean
+  /**
+   * Whether an insert may leave the column out: it has a default, or the
+   * database generates its values.
+   */
+  hasDefault: boolean
+}
+
+export interface IntrospectedEnum {
+  /**
+   * The enum's name, as columns' `enumName` gives it, e.g.
+   * `balloon_colors_enum`.
+   */
+  name: string
+  values: string[]
+}
+
+/**
+ * The types `types/db.ts` can give one value of a column. `Int8`, `Numeric`,
+ * `Timestamp` (a `DateTime` or `CalendarDate`), `Json`, `Interval`, `Point`
+ * and `Circle` are declared in that file; `Date` and `Buffer` are
+ * JavaScript's.
+ */
+export type IntrospectedValueType =
+  | 'string'
+  | 'number'
+  | 'boolean'
+  | 'Int8'
+  | 'Numeric'
+  | 'Timestamp'
+  | 'Date'
+  | 'ClockTime'
+  | 'ClockTimeTz'
+  | 'Json'
+  | 'Buffer'
+  | 'Interval'
+  | 'Point'
+  | 'Circle'
+  | 'enum'

package/docs/assets/hierarchy.js

@@ -1 +1 @@
-window.hierarchyData = "eJyVklFPwjAQx7/LPVf0GGxjj0JMjBE1MfpAeCjb4Rq6lrQdZiF8d1N5qYiuPLVp7t/fr9fbg9HaWSgWmE5yhohLBobWkkontLJQ7AER/aJ4Q1DAS0ummxmxI3PLLQGDjVAVFDjMGbRGQgGl5NaSva5Wg5PqQe0aCexYAQU4W135+NXxgEFZC1kZUlAsEhwtDwwSHAX0h86S7IJbe/i/6i8xwCSdeAW/Bg7P2roPQzbe4kyix8NT03QYUKc1lZupVtYZLpR7E1py/0X/ockYbezgr2iMQ34TOmjZNuppR2Yt9WcM+UcghjfJA96MO36vSt1suRMrSe/C1f5sxS3dCZJVhELvHRdNRJoOmW8Kwwwzhlky/h6QDLMT7dduS8fX+92jsA13ZR3pez4c0b4sGQcec+3mrZSXjMpppI95OHwBEYFvHQ=="
+window.hierarchyData = "eJyVkkFvwjAMhf+Lz4EppQq0x4EmTdPYJk3bAXEIrVkj0gTFKVOF+O9TxqUwWMPJUeTn9+XFe3DWeoJ8wUU6ZpzzJQOHa42FV9YQ5HvgnIdiZI2Qw1uDrp05tUN3LwmBwUaZEnKeTBg0TkMOhZZESHflanjWPax8rYEdOyAHT+UgyAfHCwZFpXTp0EC+SLJseWCQZFnH/akl1G1nao//n/5bCPhoJAJCqB2GV0v+yyHFU1xQ9HAEV3GS+7TCYjO1hryTyvgPZbUMX/SfNTpnHQ2vSWMYkm76U6ub2rzs0K21/Y5xPhHE+KXjjt9MevloCltvpVcrjZ/KV+FuJQkfFOoyAqF3xk0bIThnIRTGhRCMi0n6uyBCiDPs93aLx9eH07OiWvqiiuS9LI6Jb5J2OObWzxutb1mVc0mf5+HwAx1tbyM="

package/docs/assets/navigation.js

@@ -1 +1 @@
-window.navigationData = "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"
+window.navigationData = "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"