@webiny/api-headless-cms-ddb-es 5.34.8 → 5.35.0-beta.1

package/types.js.map

@@ -1 +1 @@
-{"version":3,"names":["ENTITIES"],"sources":["types.ts"],"sourcesContent":["import { Plugin, PluginCollection } from \"@webiny/plugins/types\";\nimport {\n    CmsContext as BaseCmsContext,\n    CmsEntry,\n    CmsModel,\n    CmsModelField,\n    CmsModelFieldToGraphQLPlugin,\n    HeadlessCmsStorageOperations as BaseHeadlessCmsStorageOperations\n} from \"@webiny/api-headless-cms/types\";\nimport { DynamoDBTypes, TableConstructor } from \"dynamodb-toolbox/dist/classes/Table\";\nimport { DocumentClient } from \"aws-sdk/clients/dynamodb\";\nimport {\n    EntityAttributeConfig,\n    EntityCompositeAttributes\n} from \"dynamodb-toolbox/dist/classes/Entity\";\nimport { Client } from \"@elastic/elasticsearch\";\nimport { Entity, Table } from \"dynamodb-toolbox\";\nimport { PluginsContainer } from \"@webiny/plugins\";\n\n/**\n * A definition of the entry that is being prepared for the Elasticsearch.\n *\n * @category Elasticsearch\n * @category CmsEntry\n */\nexport interface CmsIndexEntry extends CmsEntry {\n    /**\n     * Values that are not going to be indexed.\n     */\n    rawValues: Record<string, any>;\n    /**\n     * A first part of the ID, without the revision.\n     * For example, we can search for all the revisions of the given entry.\n     */\n    primaryId: string;\n    /**\n     * Dev can add what ever keys they want and need. Just need to be careful not to break the entry.\n     */\n    [key: string]: any;\n}\n\n/**\n * Arguments for the method that is transforming content entry in its original form to the one we are storing to the Elasticsearch.\n *\n * @category Elasticsearch\n * @category CmsEntry\n */\ninterface CmsModelFieldToElasticsearchToParams {\n    plugins: PluginsContainer;\n    model: CmsModel;\n    field: CmsModelField;\n    /**\n     * Raw value on the entry - before prepare for storage.\n     */\n    rawValue: any;\n    /**\n     * Value prepared for storage received from base api-headless-cms package.\n     */\n    value: any;\n    getFieldIndexPlugin(fieldType: string): CmsModelFieldToElasticsearchPlugin;\n    getFieldTypePlugin(fieldType: string): CmsModelFieldToGraphQLPlugin;\n}\n\n/**\n * Arguments for the method that is transforming content entry from Elasticsearch into the original one.\n *\n * @category Elasticsearch\n * @category CmsEntry\n */\ninterface CmsModelFieldToElasticsearchFromParams {\n    plugins: PluginsContainer;\n    model: CmsModel;\n    field: CmsModelField;\n    value: any;\n    rawValue: any;\n    getFieldIndexPlugin(fieldType: string): CmsModelFieldToElasticsearchPlugin;\n    getFieldTypePlugin(fieldType: string): CmsModelFieldToGraphQLPlugin;\n}\n\ninterface ToIndexValue {\n    /**\n     * Use this key to store value for indexing.\n     */\n    value?: any;\n    /**\n     * Use this key to tell ES that this value should not be indexed.\n     */\n    rawValue?: any;\n}\n\n/**\n * A plugin defining transformation of entry for Elasticsearch.\n *\n * @category Plugin\n * @category ContentModelField\n * @category CmsEntry\n * @category Elasticsearch\n */\nexport interface CmsModelFieldToElasticsearchPlugin extends Plugin {\n    /**\n     * A plugin type\n     */\n    type: \"cms-model-field-to-elastic-search\";\n    /**\n     * A unique identifier of the field type (text, number, json, myField, ...).\n     *\n     * ```ts\n     * fieldType: \"myField\"\n     * ```\n     */\n    fieldType: string;\n    /**\n     * If you need to define a type when building an Elasticsearch query.\n     * Check [dateTimeIndexing](https://github.com/webiny/webiny-js/blob/3074165701b8b45e5fc6ac2444caace7d04ada66/packages/api-headless-cms/src/content/plugins/es/indexing/dateTimeIndexing.ts) plugin for usage example.\n     *\n     * ```ts\n     * unmappedType: \"date\"\n     * ```\n     */\n    unmappedType?: (field: CmsModelField) => string;\n    /**\n     * This is meant to do some transformation of the entry, preferably only to fieldType it was defined for. Nothing is stopping you to do anything you want to other fields, but try to separate field transformations.\n     * It returns `Partial<CmsContentIndexEntryType>`. Always return a top-level property of the entry since it is merged via spread operator.\n     *\n     * ```ts\n     * toIndex({ value }) {\n     *    return {\n     *        value: value, // This will be stored and indexed\n     *        rawValue: JSON.stringify(value) // This will be stored but excluded from indexing\n     *    };\n     * }\n     * ```\n     */\n    toIndex?: (params: CmsModelFieldToElasticsearchToParams) => ToIndexValue;\n    /**\n     * This is meant to revert a transformation done in the `toIndex` method.\n     * You have access to \"value\" or a \"rawValue\", depending on what you returned from `toIndex`.\n     *\n     * ```ts\n     * fromIndex({ value, rawValue }) {\n     *     return JSON.parse(rawValue);\n     * }\n     * ```\n     */\n    fromIndex?: (params: CmsModelFieldToElasticsearchFromParams) => any;\n}\n\nexport type AttributeDefinition = DynamoDBTypes | EntityAttributeConfig | EntityCompositeAttributes;\n\nexport type Attributes = Record<string, AttributeDefinition>;\n\nexport enum ENTITIES {\n    SYSTEM = \"CmsSystem\",\n    SETTINGS = \"CmsSettings\",\n    GROUPS = \"CmsGroups\",\n    MODELS = \"CmsModels\",\n    ENTRIES = \"CmsEntries\",\n    ENTRIES_ES = \"CmsEntriesElasticsearch\"\n}\n\nexport interface TableModifier {\n    (table: TableConstructor): TableConstructor;\n}\n\nexport interface StorageOperationsFactoryParams {\n    documentClient: DocumentClient;\n    elasticsearch: Client;\n    table?: TableModifier;\n    esTable?: TableModifier;\n    attributes?: Record<ENTITIES, Attributes>;\n    plugins?: PluginCollection;\n}\n\nexport interface HeadlessCmsStorageOperations extends BaseHeadlessCmsStorageOperations<CmsContext> {\n    getTable: () => Table;\n    getEsTable: () => Table;\n    getEntities: () => Record<\n        \"system\" | \"settings\" | \"groups\" | \"models\" | \"entries\" | \"entriesEs\",\n        Entity<any>\n    >;\n}\n\nexport interface StorageOperationsFactory {\n    (params: StorageOperationsFactoryParams): HeadlessCmsStorageOperations;\n}\n\nexport interface CmsContext extends BaseCmsContext {\n    [key: string]: any;\n}\n"],"mappings":";;;;;;;AAmBA;AACA;AACA;AACA;AACA;AACA;;AAiBA;AACA;AACA;AACA;AACA;AACA;;AAiBA;AACA;AACA;AACA;AACA;AACA;;AAsBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;IAsDYA,Q;;;WAAAA,Q;EAAAA,Q;EAAAA,Q;EAAAA,Q;EAAAA,Q;EAAAA,Q;EAAAA,Q;GAAAA,Q,wBAAAA,Q"}
+{"version":3,"names":["ENTITIES"],"sources":["types.ts"],"sourcesContent":["import { Plugin, PluginCollection } from \"@webiny/plugins/types\";\nimport {\n    CmsContext as BaseCmsContext,\n    CmsEntry,\n    CmsModel,\n    CmsModelField,\n    CmsModelFieldToGraphQLPlugin,\n    HeadlessCmsStorageOperations as BaseHeadlessCmsStorageOperations\n} from \"@webiny/api-headless-cms/types\";\nimport { DynamoDBTypes, TableConstructor } from \"dynamodb-toolbox/dist/classes/Table\";\nimport { DocumentClient } from \"aws-sdk/clients/dynamodb\";\nimport {\n    EntityAttributeConfig,\n    EntityCompositeAttributes\n} from \"dynamodb-toolbox/dist/classes/Entity\";\nimport { Client } from \"@elastic/elasticsearch\";\nimport { Entity, Table } from \"dynamodb-toolbox\";\nimport { PluginsContainer } from \"@webiny/plugins\";\n\n/**\n * A definition of the entry that is being prepared for the Elasticsearch.\n *\n * @category Elasticsearch\n * @category CmsEntry\n */\nexport interface CmsIndexEntry extends CmsEntry {\n    /**\n     * Values that are not going to be indexed.\n     */\n    rawValues: Record<string, any>;\n    /**\n     * A first part of the ID, without the revision.\n     * For example, we can search for all the revisions of the given entry.\n     */\n    primaryId: string;\n    /**\n     * Dev can add what ever keys they want and need. Just need to be careful not to break the entry.\n     */\n    [key: string]: any;\n}\n\n/**\n * Arguments for the method that is transforming content entry in its original form to the one we are storing to the Elasticsearch.\n *\n * @category Elasticsearch\n * @category CmsEntry\n */\ninterface CmsModelFieldToElasticsearchToParams {\n    plugins: PluginsContainer;\n    model: CmsModel;\n    field: CmsModelField;\n    /**\n     * Raw value on the entry - before prepare for storage.\n     */\n    rawValue: any;\n    /**\n     * Value prepared for storage received from base api-headless-cms package.\n     */\n    value: any;\n    getFieldIndexPlugin(fieldType: string): CmsModelFieldToElasticsearchPlugin;\n    getFieldTypePlugin(fieldType: string): CmsModelFieldToGraphQLPlugin;\n}\n\n/**\n * Arguments for the method that is transforming content entry from Elasticsearch into the original one.\n *\n * @category Elasticsearch\n * @category CmsEntry\n */\ninterface CmsModelFieldToElasticsearchFromParams {\n    plugins: PluginsContainer;\n    model: CmsModel;\n    field: CmsModelField;\n    value: any;\n    rawValue: any;\n    getFieldIndexPlugin(fieldType: string): CmsModelFieldToElasticsearchPlugin;\n    getFieldTypePlugin(fieldType: string): CmsModelFieldToGraphQLPlugin;\n}\n\ninterface ToIndexValue {\n    /**\n     * Use this key to store value for indexing.\n     */\n    value?: any;\n    /**\n     * Use this key to tell ES that this value should not be indexed.\n     */\n    rawValue?: any;\n}\n\n/**\n * A plugin defining transformation of entry for Elasticsearch.\n *\n * @category Plugin\n * @category ContentModelField\n * @category CmsEntry\n * @category Elasticsearch\n */\nexport interface CmsModelFieldToElasticsearchPlugin extends Plugin {\n    /**\n     * A plugin type\n     */\n    type: \"cms-model-field-to-elastic-search\";\n    /**\n     * A unique identifier of the field type (text, number, json, myField, ...).\n     *\n     * ```ts\n     * fieldType: \"myField\"\n     * ```\n     */\n    fieldType: string;\n    /**\n     * If you need to define a type when building an Elasticsearch query.\n     * Check [dateTimeIndexing](https://github.com/webiny/webiny-js/blob/3074165701b8b45e5fc6ac2444caace7d04ada66/packages/api-headless-cms/src/content/plugins/es/indexing/dateTimeIndexing.ts) plugin for usage example.\n     *\n     * ```ts\n     * unmappedType: \"date\"\n     * ```\n     */\n    unmappedType?: (field: Pick<CmsModelField, \"fieldId\" | \"type\">) => string;\n    /**\n     * This is meant to do some transformation of the entry, preferably only to fieldType it was defined for. Nothing is stopping you to do anything you want to other fields, but try to separate field transformations.\n     * It returns `Partial<CmsContentIndexEntryType>`. Always return a top-level property of the entry since it is merged via spread operator.\n     *\n     * ```ts\n     * toIndex({ value }) {\n     *    return {\n     *        value: value, // This will be stored and indexed\n     *        rawValue: JSON.stringify(value) // This will be stored but excluded from indexing\n     *    };\n     * }\n     * ```\n     */\n    toIndex?: (params: CmsModelFieldToElasticsearchToParams) => ToIndexValue;\n    /**\n     * This is meant to revert a transformation done in the `toIndex` method.\n     * You have access to \"value\" or a \"rawValue\", depending on what you returned from `toIndex`.\n     *\n     * ```ts\n     * fromIndex({ value, rawValue }) {\n     *     return JSON.parse(rawValue);\n     * }\n     * ```\n     */\n    fromIndex?: (params: CmsModelFieldToElasticsearchFromParams) => any;\n}\n\nexport type AttributeDefinition = DynamoDBTypes | EntityAttributeConfig | EntityCompositeAttributes;\n\nexport type Attributes = Record<string, AttributeDefinition>;\n\nexport enum ENTITIES {\n    SYSTEM = \"CmsSystem\",\n    SETTINGS = \"CmsSettings\",\n    GROUPS = \"CmsGroups\",\n    MODELS = \"CmsModels\",\n    ENTRIES = \"CmsEntries\",\n    ENTRIES_ES = \"CmsEntriesElasticsearch\"\n}\n\nexport interface TableModifier {\n    (table: TableConstructor): TableConstructor;\n}\n\nexport interface StorageOperationsFactoryParams {\n    documentClient: DocumentClient;\n    elasticsearch: Client;\n    table?: TableModifier;\n    esTable?: TableModifier;\n    attributes?: Record<ENTITIES, Attributes>;\n    plugins?: PluginCollection;\n}\n\nexport interface HeadlessCmsStorageOperations extends BaseHeadlessCmsStorageOperations<CmsContext> {\n    getTable: () => Table;\n    getEsTable: () => Table;\n    getEntities: () => Record<\n        \"system\" | \"settings\" | \"groups\" | \"models\" | \"entries\" | \"entriesEs\",\n        Entity<any>\n    >;\n}\n\nexport interface StorageOperationsFactory {\n    (params: StorageOperationsFactoryParams): HeadlessCmsStorageOperations;\n}\n\nexport interface CmsContext extends BaseCmsContext {\n    [key: string]: any;\n}\n"],"mappings":";;;;;;AAmBA;AACA;AACA;AACA;AACA;AACA;AAiBA;AACA;AACA;AACA;AACA;AACA;AAiBA;AACA;AACA;AACA;AACA;AACA;AAsBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAPA,IA6DYA,QAAQ;AAAA;AAAA,WAARA,QAAQ;EAARA,QAAQ;EAARA,QAAQ;EAARA,QAAQ;EAARA,QAAQ;EAARA,QAAQ;EAARA,QAAQ;AAAA,GAARA,QAAQ,wBAARA,QAAQ"}