@prefecthq/prefect-ui-library 2.9.18 → 2.10.0

package/src/localization/locale/en.ts

@@ -0,0 +1,214 @@
+export const en = {
+  docs: {
+    artifacts: 'https://docs.prefect.io/concepts/artifacts',
+    gettingStarted: 'https://docs.prefect.io/getting-started/overview/',
+    flows: 'https://docs.prefect.io/concepts/flows/',
+    flowRuns: 'https://docs.prefect.io/concepts/flow-runs/',
+    blocks: 'https://docs.prefect.io/concepts/blocks/',
+    workQueues: 'https://docs.prefect.io/ui/work-queues/',
+    notifications: 'https://docs.prefect.io/latest/guides/host/#devex-notifications',
+    deployments: 'https://docs.prefect.io/latest/concepts/deployments/',
+    concurrency: 'https://docs.prefect.io/concepts/tasks#task-run-concurrency-limits',
+    globalConcurrency: 'https://docs.prefect.io/guides/global-concurrency-limits/',
+    automations: 'https://docs.prefect.io/ui/automations/',
+    automationTriggers: 'https://docs.prefect.io/ui/automations/#triggers',
+    workPools: 'https://docs.prefect.io/latest/concepts/work-pools/',
+    collections: 'https://docs.prefect.io/collections/catalog/',
+    resultsPersistence: 'https://docs.prefect.io/concepts/results/#persisting-results',
+    infrastructure: 'https://docs.prefect.io/latest/concepts/infrastructure/',
+    variables: 'https://docs.prefect.io/latest/guides/variables/',
+  },
+  error: {
+    activateDeployment: 'Failed to activate deployment',
+    activateDeploymentSchedule: 'Failed to activate deployment schedule',
+    activateNotification: 'Failed to activate notification',
+    activateWorkPool: 'Failed to activate work pool',
+    activateWorkPoolQueue: 'Failed to activate work queue',
+    activateWorkQueue: 'Failed to activate work queue',
+    cancelFlowRun: 'Failed to cancel flow run',
+    changeFlowRunState: 'Failed to change flow run state',
+    changeTaskRunState: 'Failed to change task run state',
+    createBlock: 'Failed to create block',
+    createConcurrencyLimit: 'Failed to create concurrency limit',
+    resetConcurrencyLimit: 'Failed to reset concurrency limit',
+    createNotification: 'Failed to create notification',
+    createSavedSearch: 'Failed to create saved filter',
+    createSchedule: 'Failed to create schedule',
+    createVariable: 'Failed to create variable',
+    createWorkPool: 'Failed to create work pool',
+    createWorkPoolQueue: 'Failed to create work queue',
+    createWorkQueue: 'Failed to create work queue',
+    delete: (type: string) => `Failed to delete ${type}`,
+    deleteSavedSearch: 'Failed to delete saved filter',
+    editVariable: 'Failed to updated variable',
+    invalidJSON: 'Invalid JSON',
+    pauseDeployment: 'Failed to pause deployment',
+    pauseDeploymentSchedule: 'Failed to deactivate deployment schedule',
+    pauseNotification: 'Failed to pause notification',
+    pauseWorkPool: 'Failed to pause work pool',
+    pauseWorkPoolQueue: 'Failed to pause work queue',
+    pauseWorkQueue: 'Failed to pause work queue',
+    removeSchedule: 'Failed to remove schedule',
+    resumeFlowRun: 'Failed to resume flow run',
+    retryRun: 'Failed to retry flow run',
+    scheduleFlowRun: 'Failed to schedule flow run',
+    arrayValueTooLong: (property: string, max: number) => `${property} must have fewer than ${max} items`,
+    stringValueTooLong: (property: string, max: number) => `${property} must be less than or equal to ${max} characters`,
+    numberValueTooLarge: (property: string, max: number) => `${property} must be less than or equal to ${max}`,
+    valueTooLarge: (property: string, max: number) => `${property} must be less than or equal to ${max}`,
+    mustBeSnakeCase: (property: string) => `${property} may only contain letters, numbers, and underscores and may not begin or end with an underscore`,
+    submitNotification: 'Failed to submit notification',
+    suspendFlowRun: 'Failed to suspend flow run',
+    updateBlock: 'Failed to update block',
+    updateConcurrencyLimit: 'Failed to update concurrency limit',
+    updateDeploymentSchedule: 'Failed to update deployment schedule',
+    updateNotification: 'Failed to update notification',
+    updateSchedule: 'Failed to update schedule',
+    updateWorkPool: 'Failed to update work pool',
+    updateWorkPoolQueue: 'Failed to update work queue',
+    updateWorkQueue: 'Failed to update work queue',
+    variableAlreadyExists: 'A variable with this name already exists',
+    automationToggle: (enabled: boolean) => enabled ? 'Sorry, something went wrong enabling your automation' : 'Sorry, something went wrong disabling your automation',
+    automationDelete: 'Sorry, something went wrong deleting your automation',
+    automationCreate: 'Sorry, something went wrong creating your automation',
+    automationUpdate: 'Sorry, something went wrong updating your automation',
+  },
+  success: {
+    activateDeployment: 'Deployment active',
+    activateDeploymentSchedule: 'Deployment schedule active',
+    activateNotification: 'Notification active',
+    activateWorkPool: 'Work pool active',
+    activateWorkPoolQueue: 'Work queue active',
+    activateWorkQueue: 'Work queue active',
+    cancelFlowRun: 'Flow run cancelled',
+    changeFlowRunState: 'Flow run state changed',
+    changeTaskRunState: 'Task run state changed',
+    createBlock: 'Block created',
+    createConcurrencyLimit: 'Concurrency limit added',
+    resetConcurrencyLimit: 'Concurrency limit reset',
+    createNotification: 'Notification created',
+    createSavedSearch: 'Filter saved',
+    createSchedule: 'Schedule added',
+    createVariable: 'Variable created',
+    createWorkPool: 'Work pool created',
+    createWorkPoolQueue: 'Work queue created',
+    createWorkQueue: 'Work queue created',
+    delete: (type: string) => `${type} deleted`,
+    deleteSavedSearch: 'Saved filter deleted',
+    editVariable: 'Variable updated',
+    pauseDeployment: 'Deployment paused',
+    pauseDeploymentSchedule: 'Deployment schedule inactive',
+    pauseNotification: 'Notification paused',
+    pauseWorkPool: 'Work pool paused',
+    pauseWorkPoolQueue: 'Work queue paused',
+    pauseWorkQueue: 'Work queue paused',
+    removeSchedule: 'Schedule removed',
+    resumeFlowRun: 'Flow run resumed',
+    retryRun: 'Retrying run',
+    scheduleFlowRun: 'Flow run scheduled',
+    suspendFlowRun: 'Flow run suspended',
+    updateBlock: 'Block updated',
+    updateDeploymentSchedule: 'Deployment schedule updated',
+    updateNotification: 'Notification updated',
+    updateConcurrencyLimit: 'Concurrency limit updated',
+    updateSchedule: 'Schedule updated',
+    updateWorkPool: 'Work pool updated',
+    updateWorkPoolQueue: 'Work queue updated',
+    updateWorkQueue: 'Work queue updated',
+    automationEnable: (enabled: boolean = true) => enabled ? 'Automation enabled' : 'Automation disabled',
+    automationDelete: 'Automation deleted',
+    automationCreate: 'Automation created',
+    automationUpdate: 'Automation updated',
+  },
+  info: {
+    form: 'Form',
+    json: 'JSON',
+    schemaHasNoProperties: 'This schema has no properties',
+    filtersActive: 'Filters active',
+    resetFilters: 'Reset filters',
+    deploymentName: 'Deployment name',
+    searchByDeploymentName: 'Search by deployment name',
+    workPools: 'Work Pools',
+    all: 'All',
+    active: 'Active',
+    inactive: 'Inactive',
+    lastFlowRunState: 'Last Flow Run State',
+    lastFlowRunStart: 'Last Flow Run Start',
+    schedule: 'Schedule',
+    with: 'with',
+    artifact: 'Artifact',
+    artifacts: 'Artifacts',
+    artifactsEmptyState: 'Artifacts are byproducts of your runs; they can be anything from a markdown string to a table.',
+    parameters: 'Parameters',
+    addTagPlaceholder: 'Add tag (press enter to submit)',
+    descriptionPlaceholder: 'Add a description (supports Markdown)',
+    parentFlowRun: 'Parent Flow Run',
+    flow: 'Flow',
+    searchByFlowName: 'Search by flow name',
+    deploymentTags: 'Deployment tags',
+    artifactSearch: 'Search artifacts',
+    variablesSearch: 'Search variables',
+    artifactCreated: (key: string) => `Created __${key}__`,
+    artifactTypeChanged: (type: string) => `Changed to \`${type}\` artifact`,
+    newVariable: 'New variable',
+    editVariable: (name: string) => `Edit \`${name}\``,
+    deployment: 'Deployment',
+    close: 'Close',
+    save: 'Save',
+    name: 'Name',
+    thisVariable: 'this variable',
+    theseVariables: 'these variables',
+    value: 'Value',
+    latest: 'Latest',
+    item: 'Item',
+    noData: 'No data',
+    noVariables: 'No variables',
+    noDeployments: 'No deployments',
+    noFlowsOrDeploymentsMatchFilter: 'No flows or deployments match your filters',
+    deploymentsEmptyStateDescription: (flowName: string = 'flows') => `Create a deployment to begin remotely managing __${flowName}__`,
+    copyId: 'Copy ID',
+    copyName: 'Copy name',
+    copyValue: 'Copy value',
+    edit: 'Edit',
+    noSchedule: 'No schedule',
+    delete: 'Delete',
+    tags: 'Tags',
+    values: 'Values',
+    nextRun: 'Next run',
+    lastRun: 'Last run',
+    workPool: 'Work Pool',
+    workQueue: 'Work Queue',
+    filterByTags: 'Filter by tags',
+    invalidData: (docsUrl: string) => `Invalid data, see [documentation](${docsUrl}) for more information`,
+    result: 'Result',
+    noResults: 'No tracked results, enable [result persistence](https://docs.prefect.io/concepts/results/#persisting-results) to track results.',
+    none: 'None',
+    noDescription: 'No description',
+    dashboardWorkPoolCardTitle: 'Active Work Pools',
+    dashboardWorkPoolCardEmpty: 'There are no active work pools to show. Any work pools you do have are paused.',
+    dashboardWorkPoolCardViewAll: 'View all work pools',
+    percentChangeOverTimePeriod: (percent: string | number) => `${percent}% change compared to the previous time period.`,
+    infraOverrides: 'Infrastructure Overrides',
+    terminalTaskRunNoArtifacts: 'This task run did not produce any artifacts; for more information on creating artifacts, see the [documentation](https://docs.prefect.io/concepts/artifacts).',
+    nonTerminalTaskRunNoArtifacts: 'This task run has not yet produced artifacts; for more information on creating artifacts, see the [documentation](https://docs.prefect.io/concepts/artifacts).',
+    terminalFlowRunNoArtifacts: 'This run did not produce any artifacts; for more information on creating artifacts, see the [documentation](https://docs.prefect.io/concepts/artifacts).',
+    nonTerminalFlowRunNoArtifacts: 'This run has not yet produced artifacts; for more information on creating artifacts, see the [documentation](https://docs.prefect.io/concepts/artifacts).',
+    flowRun: 'Flow run',
+    taskRun: 'Task run',
+    taskRuns: 'Task runs',
+    variable: 'Variable',
+    variables: 'Variables',
+    created: 'Created',
+    create: 'Create',
+    lastUpdated: 'Last Updated',
+    deprecatedWorkQueue: 'This work queue uses a deprecated tag-based approach to matching flow runs; it will continue to work but you can\'t modify it',
+    deploymentMissingWorkQueue: 'This deployment doesn\'t have an associated work queue; runs will be scheduled but won\'t be picked up by your agents',
+    taskInput: 'Task inputs show parameter keys and can also show task run relationships.',
+    workPoolInfrastructureConfigurationInstructions: 'Below you can configure defaults for deployments that use this work pool. Use the editor in the **Advanced** section to modify the existing configuration options, if needed.\nIf you don\'t need to change the default configuration, click **Create** to create your work pool!',
+    workPoolInfrastructureConfigurationAgent: 'Prefect Agents handle infrastructure configuration via infrastructure blocks attached to deployments. You can hit **Create** to create this work pool and then head over to the **Blocks** tab to create an infrastructure block for your deployments.\nTo learn more about how to configure infrastructure for Prefect Agents, check out the [docs](https://docs.prefect.io/latest/concepts/infrastructure/).',
+    disableFlowRunCancel: 'Only runs created from a deployment can be cancelled',
+    flowRunGraphNotDisplayedHeader: 'Manual graph rendering',
+    flowRunGraphNotDisplayedCopy: 'Large graphs are hidden by default. They may take time to generate and in extreme circumstances, may impact browser performance.',
+    flowRunGraphNotDisplayedCta: 'Display graph',
+  },
+}

package/src/maps/.eslintrc.json

@@ -0,0 +1,5 @@
+{
+  "rules": {
+    "camelcase": "off"
+  }
+}

package/src/maps/README.md

@@ -0,0 +1,62 @@
+## How to use the mapper service ##
+
+| Argument | Type | Description |
+| -- | -- | -- |
+| source | `string` | String representation of the source type. Available options are predefined, available through intellisense, and enforce what types are allowed to be passed as "value" argument. Instructions for adding additional options below. |
+| value | `T` |  Source type provided by "source" argument narrows the available `MapperFunction`, `T` will equal the argument of whatever `MapperFunction` claims to be responsible for the given "source" argument.  |
+| destination |  `string` | String representation of the desired destination type. Available options are predefined, available through intellisense, and narrowed to only the available destinations for the given "source" argument | 
+
+example converting `Date` => `string`
+```ts
+import { mapper } from '@prefecthq/prefect-ui-library'
+
+const mySourceValue = new Date()
+const myDestinationValue = mapper.map('Date', mySourceValue, 'string')
+
+// "2022-04-07T19:28:24.264Z"
+```
+
+## Adding new Mapper profiles ##
+In order for the mapper to know how to map from `BlueType` to `RedType`, we need to define a [`MapperFunction`](https://github.com/PrefectHQ/prefect-ui-library/src/services/Mapper.ts).
+```ts 
+import { MapFunction } from '@/services/Mapper'
+
+export const mapBlueTypeToRedType: MapFunction<BlueType, RedType> = function(source: BlueType): RedType {
+  ...
+}
+```
+- the name of this const doesn't _actually_ matter, but `'map${SOURCE_TYPE}To${DEST_TYPE}'` is the standard
+- this function will be bound to the singleton `mapper`, so when within the function, `this` will be an instance of the same mapper. This is extremely useful for nesting mappers. Think of models such as `FlowRun`, which has a property `state`. Because we have a mapper for state, you can simply use `this.map('StateResponse', source.state, 'State')` for that property. Or a simpler example would be going to/from Date/string within _most_ map functions. Please avoid infinite nesting 🙃 
+- because of the point above, it's important to define your function as I've done above and not as an arrow function as you would lose the context.
+- the name of this file doesn't _actually_ matter, but camel case of the destination type is the standard, which in this case is `src/maps/redType.ts`.
+
+You're not done yet, just creating this map function does NOT make it available to `mapper.map`. The next step is to add your map function to that [predefined index](https://github.com/PrefectHQ/prefect-ui-library/src/maps/index.ts) I mentioned above.
+
+```ts
+import { mapBlueTypeToRedType } from './redType'
+
+export const maps = {
+  ...
+  BlueType: {
+    RedType: mapBlueTypeToRedType
+  }
+  ...
+}
+```
+
+the format for this object is `{ source: { destination: mapFunction } }`
+
+That's it  🙌  now you can use `mapper.map('BlueType', eiffel65, 'RedType')`
+
+## Mapping Array or Record types ##
+Mapper is happy to accept arrays or objects!
+
+```ts
+const ex1 = mapper.map('string', '100', 'number') // 100
+const ex2 = mapper.map('string', ['100'], 'number') // [100]
+const ex3 = mapper.map('string', ['100', '101'], 'number') // [100, 101]
+const ex4 = mapper.mapEntries('string', { foo: '100', bar: '101' }, 'number') // { foo: 100, bar: 101 }
+```
+
+## Future enhancements ##
+- MapFunctions could be async? In the case where the source has `flow_id:string`, and destination has `flow:Flow` you'd need to run to the server to get the value.

package/src/maps/artifact.ts

@@ -0,0 +1,37 @@
+import { ArtifactCollectionResponse } from '@/models/api/ArtifactCollectionResponse'
+import { ArtifactResponse } from '@/models/api/ArtifactResponse'
+import { Artifact } from '@/models/Artifact'
+import { ArtifactCollection } from '@/models/ArtifactCollection'
+import { MapFunction } from '@/services/Mapper'
+import { isKnownArtifactType } from '@/types/artifact'
+
+export const mapArtifactResponseToArtifact: MapFunction<ArtifactResponse, Artifact> = function(source) {
+  return new Artifact({
+    id: source.id,
+    created: this.map('string', source.created, 'Date'),
+    updated: this.map('string', source.updated, 'Date'),
+    description: source.description,
+    key: source.key,
+    type: isKnownArtifactType(source.type) ? source.type : 'unknown',
+    data: source.data,
+    metadata: source.metadata_,
+    flowRunId: source.flow_run_id,
+    taskRunId: source.task_run_id,
+  })
+}
+
+export const mapArtifactCollectionResponseToArtifactCollection: MapFunction<ArtifactCollectionResponse, ArtifactCollection> = function(source) {
+  return new ArtifactCollection({
+    id: source.id,
+    latestId: source.latest_id,
+    created: this.map('string', source.created, 'Date'),
+    updated: this.map('string', source.updated, 'Date'),
+    description: source.description,
+    key: source.key,
+    type: isKnownArtifactType(source.type) ? source.type : 'unknown',
+    data: source.data,
+    metadata: source.metadata_,
+    flowRunId: source.flow_run_id,
+    taskRunId: source.task_run_id,
+  })
+}

package/src/maps/blockDocument.ts

@@ -0,0 +1,31 @@
+import { SelectOption } from '@prefecthq/prefect-design'
+import { BlockDocumentResponse } from '@/models/api/BlockDocumentResponse'
+import { BlockDocument } from '@/models/BlockDocument'
+import { createObjectLevelCan } from '@/models/ObjectLevelCan'
+import { MapFunction } from '@/services/Mapper'
+
+export const mapBlockDocumentResponseToBlockDocument: MapFunction<BlockDocumentResponse, BlockDocument> = function(source) {
+  const blockSchema = this.map('BlockSchemaResponse', source.block_schema, 'BlockSchema')
+
+  return new BlockDocument({
+    id: source.id,
+    name: source.name,
+    isAnonymous: source.is_anonymous,
+    blockSchemaId: source.block_schema_id,
+    blockTypeId: source.block_type_id,
+    created: this.map('string', source.created, 'Date'),
+    updated: this.map('string', source.updated, 'Date'),
+    blockDocumentReferences: this.map('BlockDocumentReferencesResponse', source.block_document_references, 'BlockDocumentReferences'),
+    blockType: this.map('BlockTypeResponse', source.block_type, 'BlockType'),
+    blockSchema,
+    data: this.map('SchemaValuesResponse', { values: source.data, references: source.block_document_references, schema: blockSchema.fields }, 'SchemaValues'),
+    can: createObjectLevelCan(),
+  })
+}
+
+export const mapBlockDocumentToSelectOption: MapFunction<BlockDocument, SelectOption> = function({ name, id }) {
+  return {
+    label: name,
+    value: id,
+  }
+}

package/src/maps/blockDocumentCreate.ts

@@ -0,0 +1,26 @@
+import { BlockDocumentCreateRequest } from '@/models/api/BlockDocumentCreateRequest'
+import { BlockDocumentCreate, isBlockDocumentCreateNamed } from '@/models/BlockDocumentCreate'
+import { MapFunction } from '@/services/Mapper'
+
+
+export const mapBlockDocumentCreateToBlockDocumentCreateRequest: MapFunction<BlockDocumentCreate, BlockDocumentCreateRequest> = function(source) {
+  const { blockSchema, data: values } = source
+  const schema = blockSchema.fields
+  const data = this.map('SchemaValues', { values, schema }, 'SchemaValuesRequest')
+
+  if (isBlockDocumentCreateNamed(source)) {
+    return {
+      name: source.name,
+      block_schema_id: blockSchema.id,
+      block_type_id: blockSchema.blockTypeId,
+      data,
+    }
+  }
+
+  return {
+    is_anonymous: source.isAnonymous,
+    block_schema_id: blockSchema.id,
+    block_type_id: blockSchema.blockTypeId,
+    data,
+  }
+}

package/src/maps/blockDocumentReferences.ts

@@ -0,0 +1,22 @@
+import { BlockDocumentReferencesResponse, BlockDocumentReferences, BlockDocumentReference } from '@/models'
+import { MapFunction } from '@/services/Mapper'
+
+export const mapBlockDocumentResponseReferencesToBlockDocumentReferences: MapFunction<BlockDocumentReferencesResponse, BlockDocumentReferences> = function(source) {
+  const result: BlockDocumentReferences = {}
+
+  return Object.keys(source).reduce((result, key) => {
+    const { block_document } = source[key]!
+    const { block_type } = block_document
+
+    const reference: BlockDocumentReference = {
+      id: block_document.id,
+      isAnonymous: block_document.is_anonymous,
+      name: block_document.name,
+      blockType: this.map('BlockTypeResponse', block_type, 'BlockType'),
+    }
+
+    result[key] = reference
+
+    return result
+  }, result)
+}

package/src/maps/blockDocumentUpdate.ts

@@ -0,0 +1,14 @@
+import { BlockDocumentUpdateRequest } from '@/models/api/BlockDocumentUpdateRequest'
+import { BlockDocumentUpdate } from '@/models/BlockDocumentUpdate'
+import { MapFunction } from '@/services/Mapper'
+
+export const mapBlockDocumentUpdateToBlockDocumentUpdateRequest: MapFunction<BlockDocumentUpdate, BlockDocumentUpdateRequest> = function(source) {
+  const { blockSchema, data: values, mergeExistingData } = source
+  const schema = blockSchema.fields
+  const data = this.map('SchemaValues', { values, schema }, 'SchemaValuesRequest')
+
+  return {
+    data,
+    merge_existing_data: mergeExistingData,
+  }
+}

package/src/maps/blockSchema.ts

@@ -0,0 +1,16 @@
+import { BlockSchemaResponse } from '@/models/api/BlockSchemaResponse'
+import { BlockSchema } from '@/models/BlockSchema'
+import { MapFunction } from '@/services/Mapper'
+
+export const mapBlockSchemaResponseToBlockSchema: MapFunction<BlockSchemaResponse, BlockSchema> = function(source) {
+  return new BlockSchema({
+    id: source.id,
+    checksum: source.checksum,
+    blockTypeId: source.block_type_id,
+    capabilities: source.capabilities,
+    created: this.map('string', source.created, 'Date'),
+    updated: this.map('string', source.updated, 'Date'),
+    fields: this.map('SchemaResponse', source.fields, 'Schema'),
+    blockType: this.map('BlockTypeResponse', source.block_type, 'BlockType'),
+  })
+}

package/src/maps/blockSchemaReferences.ts

@@ -0,0 +1,11 @@
+import { BlockSchemaReferencesResponse } from '@/models/api/SchemaResponse'
+import { MapFunction } from '@/services/Mapper'
+import { BlockSchemaReferences } from '@/types/schemas'
+import { mapValues } from '@/utilities'
+
+export const mapBlockSchemaReferencesResponseToBlockSchemaReferences: MapFunction<BlockSchemaReferencesResponse, BlockSchemaReferences> = function(source) {
+  return mapValues(source, (key, value) => ({
+    blockSchemaChecksum: value!.block_schema_checksum,
+    blockTypeSlug: value!.block_type_slug,
+  }))
+}

package/src/maps/blockType.ts

@@ -0,0 +1,17 @@
+import { BlockTypeResponse } from '@/models/api/BlockTypeResponse'
+import { BlockType } from '@/models/BlockType'
+import { MapFunction } from '@/services/Mapper'
+
+export const mapBlockTypeResponseToBlockType: MapFunction<BlockTypeResponse, BlockType> = function(source) {
+  return new BlockType({
+    id: source.id,
+    name: source.name,
+    slug: source.slug,
+    logoUrl: source.logo_url,
+    documentationUrl: source.documentation_url,
+    description: source.description,
+    codeExample: source.code_example,
+    created: this.map('string', source.created, 'Date'),
+    updated: this.map('string', source.updated, 'Date'),
+  })
+}

package/src/maps/collectionItem.ts

@@ -0,0 +1,28 @@
+import { CollectionItem, CollectionItemResponse, CollectionsResponse } from '@/models'
+import { MapFunction } from '@/services/Mapper'
+
+export const mapCollectionItemResponseToCollectionItem: MapFunction<CollectionItemResponse, CollectionItem> = function(source) {
+  return {
+    collectionType: 'flow',
+    name: source.name,
+    description: source.description.summary,
+    returns: source.description.returns,
+    examples: source.description.examples,
+    documentationUrl: source.documentation_url,
+    entrypoint: source.entrypoint,
+    installCommand: source.install_command,
+    logoUrl: source.logo_url,
+    parameters: source.parameters,
+    path: source.path_containing_flow,
+    repositoryUrl: source.repo_url,
+    slug: source.slug,
+  }
+}
+
+export const mapCollectionResponseToCollectionItems: MapFunction<CollectionsResponse, CollectionItem[]> = function(source) {
+  return Object.entries(source).flatMap(([category, collection]) => {
+    const mapped = this.map('CollectionItemResponse', Object.values(collection), 'CollectionItem')
+
+    return mapped.map(item => ({ ...item, category }))
+  })
+}

package/src/maps/concurrencyLimit.ts

@@ -0,0 +1,16 @@
+import { ConcurrencyLimitResponse } from '@/models/api/ConcurrencyLimitResponse'
+import { ConcurrencyLimit } from '@/models/ConcurrencyLimit'
+import { MapFunction } from '@/services/Mapper'
+
+export const mapConcurrencyLimitResponseToConcurrencyLimit: MapFunction<ConcurrencyLimitResponse, ConcurrencyLimit> = function(source) {
+  const { tag, id, created, updated } = source
+
+  return {
+    tag,
+    id,
+    created,
+    updated,
+    activeSlots: source.active_slots,
+    concurrencyLimit: source.concurrency_limit,
+  }
+}

package/src/maps/concurrencyLimitCreate.ts

@@ -0,0 +1,12 @@
+import { ConcurrencyLimitCreateRequest } from '@/models/api/ConcurrencyLimitCreateRequest'
+import { ConcurrencyLimitCreate } from '@/models/ConcurrencyLimitCreate'
+import { MapFunction } from '@/services/Mapper'
+
+export const mapConcurrencyLimitCreateToConcurrencyLimitCreateRequest: MapFunction<ConcurrencyLimitCreate, ConcurrencyLimitCreateRequest> = function(source) {
+  const { tag } = source
+
+  return {
+    tag,
+    concurrency_limit: source.concurrencyLimit,
+  }
+}

package/src/maps/concurrencyV2Limit.ts

@@ -0,0 +1,27 @@
+import { ConcurrencyV2Response } from '@/models/api/ConcurrencyV2Response'
+import { ConcurrencyV2Limit } from '@/models/ConcurrencyV2Limit'
+import { MapFunction } from '@/services/Mapper'
+
+export const mapConcurrencyV2ResponseToConcurrencyV2Limit: MapFunction<ConcurrencyV2Response, ConcurrencyV2Limit> = function(source) {
+  const {
+    id,
+    created,
+    updated,
+    active,
+    name,
+    limit,
+  } = source
+
+  return {
+    id,
+    created,
+    updated,
+    active,
+    name,
+    limit,
+    activeSlots: source.active_slots,
+    deniedSlots: source.denied_slots,
+    slotDecayPerSecond: source.slot_decay_per_second,
+    avgSlotOccupancySeconds: source.avg_slot_occupancy_seconds,
+  }
+}

package/src/maps/concurrencyV2LimitCreate.ts

@@ -0,0 +1,20 @@
+import { ConcurrencyV2CreateRequest } from '@/models/api/ConcurrencyV2CreateRequest'
+import { ConcurrencyV2Create } from '@/models/ConcurrencyV2Create'
+import { MapFunction } from '@/services/Mapper'
+
+export const mapConcurrencyV2CreateToConcurrencyV2CreateRequest: MapFunction<ConcurrencyV2Create, ConcurrencyV2CreateRequest> = function(source) {
+  const {
+    active,
+    name,
+    limit,
+  } = source
+
+  return {
+    active,
+    name,
+    limit,
+    active_slots: source.activeSlots,
+    denied_slots: source.deniedSlots,
+    slot_decay_per_second: source.slotDecayPerSecond,
+  }
+}

package/src/maps/concurrencyV2LimitUpdate.ts

@@ -0,0 +1,20 @@
+import { ConcurrencyV2UpdateRequest } from '@/models/api/ConcurrencyV2UpdateRequest'
+import { ConcurrencyV2Update } from '@/models/ConcurrencyV2Update'
+import { MapFunction } from '@/services/Mapper'
+
+export const mapConcurrencyV2UpdateToConcurrencyV2UpdateRequest: MapFunction<ConcurrencyV2Update, ConcurrencyV2UpdateRequest> = function(source) {
+  const {
+    active,
+    name,
+    limit,
+  } = source
+
+  return {
+    active,
+    name,
+    limit,
+    active_slots: source.activeSlots,
+    denied_slots: source.deniedSlots,
+    slot_decay_per_second: source.slotDecayPerSecond,
+  }
+}

package/src/maps/createdOrUpdatedBy.ts

@@ -0,0 +1,11 @@
+import { CreatedOrUpdatedByResponse } from '@/models/api/CreatedOrUpdatedByResponse'
+import { CreatedOrUpdatedBy } from '@/models/CreatedOrUpdatedBy'
+import { MapFunction } from '@/services/Mapper'
+
+export const mapCreatedOrUpdatedByResponseToCreatedOrUpdatedBy: MapFunction<CreatedOrUpdatedByResponse, CreatedOrUpdatedBy> = function(source) {
+  return {
+    id: source.id,
+    displayValue: source.display_value,
+    type: source.type,
+  }
+}