hasura-utils v1.0.6

hasura-utils

• Installation
• Synopsis
• Details
• API
• hasura-utils
  • Type aliases
    • NameFunction
    • Operation
    • TableFilterFunction
  • Variables
    • Const OPERATIONS
  • Functions
    • _untrackTable
    • createDeletePermission
    • createInsertPermission
    • createSelectPermission
    • createUpdatePermission
    • dropPermission
    • formatAndWriteData
    • getColumnNames
    • getHasuraCacheRedirectMapSource
    • getMultipleObjectName
    • getSingleObjectName
    • getTableName
    • trackTable
    • writeMigration
  • Object literals
    • Const PERMISSION_FUNCTION
    • ▪ PERMISSION_FUNCTION: object
    • delete
    • insert
    • select
    • update
• Classes
• Class: HasuraUtils
  • Hierarchy
  • Methods
    • getMetaData
    • getTrackedTables
    • writeHasureCacheRedirectMap
    • writeMigrationsCreatePermissions
    • writeMigrationsTrackTable
    • Static create
• Interfaces
• Interface: HasuraTableName
  • Hierarchy
  • Properties
    • name
    • schema
• Interface: MetaData
  • Hierarchy
  • Properties
    • tables
    • version
• Interface: Options
  • Hierarchy
  • Properties
    • Optional adminSecret
    • database
    • Optional includeSchemas
    • Optional multipleObjectNameFunction
    • password
    • Optional singleObjectNameFunction
    • Optional tableNameFunction
    • Optional url
    • user

Installation

Synopsis

Details

API

hasura-utils

hasura-utils

Type aliases

NameFunction

Ƭ NameFunction: function

Defined in index.ts:48

Type declaration:

▸ (table: string, schema?: undefined | string): string

Parameters:

Operation

Ƭ Operation: "insert" | "select" | "update" | "delete"

Defined in index.ts:49

TableFilterFunction

Ƭ TableFilterFunction: function

Defined in index.ts:50

Type declaration:

▸ (table: Table): boolean

Parameters:

Variables

Const OPERATIONS

• OPERATIONS: Operation[] = "insert", "select", "update", "delete"

Defined in index.ts:30

Functions

_untrackTable

▸ _untrackTable(table: string, schema: string): object

Defined in migration-commands/untrack-table.ts:1

Parameters:

Returns: object

• type: string = "untrack_table"

• args: object

  • table: object

    • name: string = table

    • schema: string

createDeletePermission

▸ createDeletePermission(table: string, schema: string, __namedParameters: object): object

Defined in migration-commands/create-delete-permission.ts:3

Parameters:

▪ table: string

▪Default value schema: string= "public"

▪ __namedParameters: object

Returns: object

createInsertPermission

▸ createInsertPermission(table: string, schema: string, __namedParameters: object): object

Defined in migration-commands/create-insert-permission.ts:3

Parameters:

▪ table: string

▪Default value schema: string= "public"

▪ __namedParameters: object

Returns: object

createSelectPermission

▸ createSelectPermission(table: string, schema: string, __namedParameters: object): object

Defined in migration-commands/create-select-permission.ts:3

Parameters:

▪ table: string

▪Default value schema: string= "public"

▪ __namedParameters: object

Returns: object

createUpdatePermission

▸ createUpdatePermission(table: string, schema: string, __namedParameters: object): object

Defined in migration-commands/create-update-permission.ts:3

Parameters:

▪ table: string

▪Default value schema: string= "public"

▪ __namedParameters: object

Returns: object

dropPermission

▸ dropPermission(table: string, schema: string, __namedParameters: object): object

Defined in migration-commands/drop-permission.ts:3

Parameters:

▪ table: string

▪Default value schema: string= "public"

▪ __namedParameters: object

Returns: object

formatAndWriteData

▸ formatAndWriteData<T>(data: T, format?: "json" | "yaml", file?: undefined | string): Promise‹string | T›

Defined in helper.ts:8

Type parameters:

▪ T

Parameters:

Returns: Promise‹string | T›

getColumnNames

▸ getColumnNames(table: Table, exclude: string[]): string[]

Defined in helper.ts:93

Parameters:

Returns: string[]

getHasuraCacheRedirectMapSource

▸ getHasuraCacheRedirectMapSource(map: Record‹string, string›): string

Defined in helper.ts:49

Parameters:

Returns: string

getMultipleObjectName

▸ getMultipleObjectName(table: string, schema?: undefined | string): string

Defined in helper.ts:45

Returns multiple object name used by Hasura for given PostgreSQL table.

Parameters:

Returns: string

single object name.

getSingleObjectName

▸ getSingleObjectName(table: string, schema?: undefined | string): string

Defined in helper.ts:35

Returns single object name used by Hasura for given PostgreSQL table.

Parameters:

Returns: string

single object name.

getTableName

▸ getTableName(table: string, schema?: undefined | string): string

Defined in helper.ts:25

Parameters:

Returns: string

trackTable

▸ trackTable(table: string, schema: string, options: object): object

Defined in migration-commands/track-table.ts:4

Parameters:

▪ table: string

▪ schema: string

▪ options: object

Returns: object

• type: string = "track_table"

• version: number = 2

• args: object

  • configuration: object

    • custom_root_fields: object

      • delete: string = delete${camelize(options.getMultipleObjectName(table, schema))}

      • insert: string = add${camelize(options.getMultipleObjectName(table, schema))}

      • select: string = options.getMultipleObjectName(table, schema)

      • select_aggregate: string = ${camelize(options.getTableName(table, schema), true)}Aggregate

      • select_by_pk: string = options.getSingleObjectName(table, schema)

      • update: string = update${camelize(options.getMultipleObjectName(table, schema))}

  • table: object

    • name: string = table

    • schema: string

writeMigration

▸ writeMigration(dir: string, up: object, down: object): Promise‹any›

Defined in helper.ts:21

Parameters:

Returns: Promise‹any›

Object literals

Const PERMISSION_FUNCTION

▪ PERMISSION_FUNCTION: object

Defined in index.ts:31

delete

• delete: createDeletePermission = createDeletePermission

Defined in index.ts:35

insert

• insert: createInsertPermission = createInsertPermission

Defined in index.ts:32

select

• select: createSelectPermission = createSelectPermission

Defined in index.ts:33

update

• update: createUpdatePermission = createUpdatePermission

Defined in index.ts:34

Classes

hasura-utils › HasuraUtils

Class: HasuraUtils

Hierarchy

• HasuraUtils

Methods

getMetaData

▸ getMetaData(): Promise‹MetaData›

Defined in index.ts:128

Returns: Promise‹MetaData›

getTrackedTables

▸ getTrackedTables(): Promise‹Table[]›

Defined in index.ts:140

Returns: Promise‹Table[]›

writeHasureCacheRedirectMap

▸ writeHasureCacheRedirectMap(file: string, __namedParameters: object): Promise‹string›

Defined in index.ts:206

Creates typescript file for mapping (single object name -> table name) to be used with cache redirects.

Example

import { InMemoryCache, CacheResolver } from "apollo-cache-inmemory";

function getHasuraCacheRedirects(redirectMap: Record<string, string>): Record<string, CacheResolver> {
  const result: Record<string, CacheResolver> = {};
  Object.entries(redirectMap).forEach(([singleRecordName, tableName]) => {
    result[singleRecordName] = (_, args, { getCacheKey }) => getCacheKey({ __typename: tableName, id: args.id });
  });
  return result;
}

const cache: InMemoryCache = new InMemoryCache({
  cacheRedirects: {
    Query: { ...getHasuraCacheRedirects(apolloCacheRedirectMap) }
  }
});

see https://www.apollographql.com/docs/react/caching/cache-interaction/#cache-redirects-with-cacheredirects

see https://www.apollographql.com/docs/react/performance/performance/

Parameters:

▪ file: string

is the file to wirte mapping.

▪Default value __namedParameters: object= {}

Returns: Promise‹string›

writeMigrationsCreatePermissions

▸ writeMigrationsCreatePermissions(__namedParameters: object): Promise‹string | object›

Defined in index.ts:145

Parameters:

▪ __namedParameters: object

Returns: Promise‹string | object›

writeMigrationsTrackTable

▸ writeMigrationsTrackTable(__namedParameters: object): Promise‹any›

Defined in index.ts:172

Parameters:

▪ __namedParameters: object

Returns: Promise‹any›

Static create

▸ create(__namedParameters: object): Promise‹HasuraUtils›

Defined in index.ts:92

Parameters:

▪Default value __namedParameters: object= {} as any

Returns: Promise‹HasuraUtils›

Interfaces

hasura-utils › HasuraTableName

Interface: HasuraTableName

Hierarchy

• HasuraTableName

Properties

name

• name: string

Defined in index.ts:40

schema

• schema: string

Defined in index.ts:39

hasura-utils › MetaData

Interface: MetaData

Hierarchy

• MetaData

Properties

tables

• tables: Array‹object›

Defined in index.ts:45

version

• version: number

Defined in index.ts:44

hasura-utils › Options

Interface: Options

Hierarchy

• Options

Properties

Optional adminSecret

• adminSecret? : undefined | string

Defined in index.ts:54

database

• database: string

Defined in index.ts:55

Optional includeSchemas

• includeSchemas? : string[]

Defined in index.ts:58

Optional multipleObjectNameFunction

• multipleObjectNameFunction? : NameFunction

Defined in index.ts:60

password

• password: string

Defined in index.ts:57

Optional singleObjectNameFunction

• singleObjectNameFunction? : NameFunction

Defined in index.ts:59

Optional tableNameFunction

• tableNameFunction? : NameFunction

Defined in index.ts:61

Optional url

• url? : undefined | string

Defined in index.ts:53

user

• user: string

Defined in index.ts:56