@malloy-publisher/app 0.0.55 → 0.0.59

package/dist/app/api-doc.yaml

@@ -1,1258 +0,0 @@
-openapi: 3.1.0
-info:
-  title: Malloy Publisher - Semantic Model Serving API
-  description:
-    The Malloy Publisher - Semantic Model Serving API serves Malloy packages.  A Malloy package is a directory of Malloy models (.malloy files),
-    Malloy notebooks (.malloynb files), and embedded datbases (.parque files) with a malloy-publisher.json manifest at the package's root directory.
-    For example, see the Malloy samples packages (https://github.com/malloydata/malloy-samples) repo.
-  version: v0
-servers:
-  - url: /api/v0/
-
-paths:
-  /projects:
-    get:
-      tags:
-        - projects
-      operationId: list-projects
-      summary: Returns a list of the Projects hosted on this server.
-      responses:
-        "200":
-          description: A list of the Projects names.
-          content:
-            application/json:
-              schema:
-                type: array
-                items:
-                  $ref: "#/components/schemas/Project"
-        "401":
-          $ref: "#/components/responses/UnauthorizedError"
-        "500":
-          $ref: "#/components/responses/InternalServerError"
-
-  /projects/{projectName}:
-    get:
-      tags:
-        - projects
-      operationId: get-project
-      summary: Returns metadata about the project.
-      parameters:
-        - name: projectName
-          in: path
-          description: Name of project
-          required: true
-          schema:
-            type: string
-        - name: reload
-          in: query
-          description: Load / reload the project before returning result
-          required: false
-          schema:
-            type: boolean
-      responses:
-        "200":
-          description: Metadata about the project.
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/Project"
-        "401":
-          $ref: "#/components/responses/UnauthorizedError"
-        "404":
-          $ref: "#/components/responses/NotFoundError"
-        "500":
-          $ref: "#/components/responses/InternalServerError"
-
-  /projects/{projectName}/connections:
-    get:
-      tags:
-        - connections
-      operationId: list-connections
-      summary: Returns a list of the connections in the project.
-      parameters:
-        - name: projectName
-          in: path
-          description: Name of project
-          required: true
-          schema:
-            type: string
-      responses:
-        "200":
-          description: A list of the connections in the project.
-          content:
-            application/json:
-              schema:
-                type: array
-                items:
-                  $ref: "#/components/schemas/Connection"
-        "401":
-          $ref: "#/components/responses/UnauthorizedError"
-        "500":
-          $ref: "#/components/responses/InternalServerError"
-
-  /projects/{projectName}/connections/{connectionName}:
-    get:
-      tags:
-        - connections
-      operationId: get-connection
-      summary: Returns a connection.
-      parameters:
-        - name: projectName
-          in: path
-          description: Name of project
-          required: true
-          schema:
-            type: string
-        - name: connectionName
-          in: path
-          description: Name of connection
-          required: true
-          schema:
-            type: string
-      responses:
-        "200":
-          description: A connection.
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/Connection"
-        "401":
-          $ref: "#/components/responses/UnauthorizedError"
-        "404":
-          $ref: "#/components/responses/NotFoundError"
-        "500":
-          $ref: "#/components/responses/InternalServerError"
-
-  /projects/{projectName}/connections/{connectionName}/test:
-    get:
-      tags:
-        - connections
-      operationId: get-test
-      summary: Returns a test.
-      parameters:
-        - name: projectName
-          in: path
-          description: Name of project
-          required: true
-          schema:
-            type: string
-        - name: connectionName
-          in: path
-          description: Name of connection
-          required: true
-          schema:
-            type: string
-      responses:
-        "200":
-          description: Test passed.
-        "401":
-          $ref: "#/components/responses/UnauthorizedError"
-        "404":
-          $ref: "#/components/responses/NotFoundError"
-        "500":
-          $ref: "#/components/responses/InternalServerError"
-
-  /projects/{projectName}/connections/{connectionName}/sqlSource:
-    get:
-      tags:
-        - connections
-      operationId: get-sqlsource
-      summary: Returns a SQL source.
-      parameters:
-        - name: projectName
-          in: path
-          description: Name of project
-          required: true
-          schema:
-            type: string
-        - name: connectionName
-          in: path
-          description: Name of connection
-          required: true
-          schema:
-            type: string
-        - name: sqlStatement
-          in: query
-          description: SQL statement
-          required: false
-          schema:
-            type: string
-      responses:
-        "200":
-          description: A SQL source.
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/SqlSource"
-        "401":
-          $ref: "#/components/responses/UnauthorizedError"
-        "404":
-          $ref: "#/components/responses/NotFoundError"
-        "500":
-          $ref: "#/components/responses/InternalServerError"
-
-  /projects/{projectName}/connections/{connectionName}/tableSource:
-    get:
-      tags:
-        - connections
-      operationId: get-tablesource
-      summary: Returns a table source.
-      parameters:
-        - name: projectName
-          in: path
-          description: Name of project
-          required: true
-          schema:
-            type: string
-        - name: connectionName
-          in: path
-          description: Name of connection
-          required: true
-          schema:
-            type: string
-        - name: tableKey
-          in: query
-          description: Table key
-          required: false
-          schema:
-            type: string
-        - name: tablePath
-          in: query
-          description: Table path
-          required: false
-          schema:
-            type: string
-      responses:
-        "200":
-          description: A table source.
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/TableSource"
-        "401":
-          $ref: "#/components/responses/UnauthorizedError"
-        "404":
-          $ref: "#/components/responses/NotFoundError"
-        "500":
-          $ref: "#/components/responses/InternalServerError"
-
-  /projects/{projectName}/connections/{connectionName}/schemas/{schemaName}/tables:
-    get:
-      tags:
-        - connections
-      operationId: list-tables
-      summary: Returns a list of tables available in the specified schema.
-      parameters:
-        - name: projectName
-          in: path
-          description: Name of project
-          required: true
-          schema:
-            type: string
-        - name: connectionName
-          in: path
-          description: Name of connection
-          required: true
-          schema:
-            type: string
-        - name: schemaName
-          in: path
-          description: Name of schema
-          required: true
-          schema:
-            type: string
-      responses:
-        "200":
-          description: A list of table names available in the specified schema.
-          content:
-            application/json:
-              schema:
-                type: array
-                items:
-                  type: string
-        "401":
-          $ref: "#/components/responses/UnauthorizedError"
-        "404":
-          $ref: "#/components/responses/NotFoundError"
-        "500":
-          $ref: "#/components/responses/InternalServerError"
-
-  /projects/{projectName}/connections/{connectionName}/schemas:
-    get:
-      tags:
-        - connections
-      operationId: list-schemas
-      summary: Returns a list of schemas available in the connection.
-      parameters:
-        - name: projectName
-          in: path
-          description: Name of project
-          required: true
-          schema:
-            type: string
-        - name: connectionName
-          in: path
-          description: Name of connection
-          required: true
-          schema:
-            type: string
-      responses:
-        "200":
-          description: A list of schemas available in the connection with metadata.
-          content:
-            application/json:
-              schema:
-                type: array
-                items:
-                  $ref: "#/components/schemas/SchemaName"
-        "401":
-          $ref: "#/components/responses/UnauthorizedError"
-        "404":
-          $ref: "#/components/responses/NotFoundError"
-        "500":
-          $ref: "#/components/responses/InternalServerError"
-
-  /projects/{projectName}/connections/{connectionName}/queryData:
-    get:
-      tags:
-        - connections
-      operationId: get-querydata
-      summary: Returns a query and its results.
-      parameters:
-        - name: projectName
-          in: path
-          description: Name of project
-          required: true
-          schema:
-            type: string
-        - name: connectionName
-          in: path
-          description: Name of connection
-          required: true
-          schema:
-            type: string
-        - name: sqlStatement
-          in: query
-          description: SQL statement
-          required: false
-          schema:
-            type: string
-        - name: options
-          in: query
-          description: Options
-          required: false
-          schema:
-            type: string
-      responses:
-        "200":
-          description: A query and its results.
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/QueryData"
-        "401":
-          $ref: "#/components/responses/UnauthorizedError"
-        "404":
-          $ref: "#/components/responses/NotFoundError"
-        "500":
-          $ref: "#/components/responses/InternalServerError"
-
-  /projects/{projectName}/connections/{connectionName}/temporaryTable:
-    get:
-      tags:
-        - connections
-      operationId: get-temporarytable
-      summary: Returns a temporary table.
-      parameters:
-        - name: projectName
-          in: path
-          description: Name of project
-          required: true
-          schema:
-            type: string
-        - name: connectionName
-          in: path
-          description: Name of connection
-          required: true
-          schema:
-            type: string
-        - name: sqlStatement
-          in: query
-          description: SQL statement
-          required: false
-          schema:
-            type: string
-      responses:
-        "200":
-          description: A temporary table.
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/TemporaryTable"
-        "401":
-          $ref: "#/components/responses/UnauthorizedError"
-        "404":
-          $ref: "#/components/responses/NotFoundError"
-        "500":
-          $ref: "#/components/responses/InternalServerError"
-
-  /projects/{projectName}/packages:
-    get:
-      tags:
-        - packages
-      operationId: list-packages
-      summary: Returns a list of the Packages hosted on this server.
-      parameters:
-        - name: projectName
-          in: path
-          description: Name of project
-          required: true
-          schema:
-            type: string
-      responses:
-        "200":
-          description: A list of the Packages names.
-          content:
-            application/json:
-              schema:
-                type: array
-                items:
-                  $ref: "#/components/schemas/Package"
-        "401":
-          $ref: "#/components/responses/UnauthorizedError"
-        "500":
-          $ref: "#/components/responses/InternalServerError"
-        "501":
-          $ref: "#/components/responses/NotImplementedError"
-
-  /projects/{projectName}/packages/{packageName}:
-    get:
-      tags:
-        - packages
-      operationId: get-package
-      summary: Returns the package metadata.
-      parameters:
-        - name: projectName
-          in: path
-          description: Name of project
-          required: true
-          schema:
-            type: string
-        - name: packageName
-          in: path
-          description: Package name
-          required: true
-          schema:
-            type: string
-        - name: versionId
-          in: query
-          description: Version ID
-          required: false
-          schema:
-            type: string
-        - name: reload
-          in: query
-          description: Load / reload the package before returning result
-          required: false
-          schema:
-            type: boolean
-      responses:
-        "200":
-          description: Package metadata.
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/Package"
-        "401":
-          $ref: "#/components/responses/UnauthorizedError"
-        "404":
-          $ref: "#/components/responses/NotFoundError"
-        "500":
-          $ref: "#/components/responses/InternalServerError"
-        "501":
-          $ref: "#/components/responses/NotImplementedError"
-
-  /projects/{projectName}/packages/{packageName}/models:
-    get:
-      tags:
-        - models
-      operationId: list-models
-      summary: Returns a list of relative paths to the models in the package.
-      parameters:
-        - name: projectName
-          in: path
-          description: Name of project
-          required: true
-          schema:
-            type: string
-        - name: packageName
-          in: path
-          description: Name of package
-          required: true
-          schema:
-            type: string
-        - name: versionId
-          in: query
-          description: Version ID
-          required: false
-          schema:
-            type: string
-      responses:
-        "200":
-          description: A list of relative paths to the models in the package.
-          content:
-            application/json:
-              schema:
-                type: array
-                items:
-                  $ref: "#/components/schemas/Model"
-        "401":
-          $ref: "#/components/responses/UnauthorizedError"
-        "404":
-          $ref: "#/components/responses/NotFoundError"
-        "500":
-          $ref: "#/components/responses/InternalServerError"
-        "501":
-          $ref: "#/components/responses/NotImplementedError"
-
-  /projects/{projectName}/packages/{packageName}/models/{path}:
-    get:
-      tags:
-        - models
-      operationId: get-model
-      summary: Returns a Malloy model.
-      parameters:
-        - name: projectName
-          in: path
-          description: Name of project
-          required: true
-          schema:
-            type: string
-        - name: packageName
-          in: path
-          description: Name of package.
-          required: true
-          schema:
-            type: string
-        - name: path
-          in: path
-          description: Path to model wihin the package.
-          required: true
-          schema:
-            type: string
-        - name: versionId
-          in: query
-          description: Version ID
-          required: false
-          schema:
-            type: string
-      responses:
-        "200":
-          description: A Malloy model.
-          content:
-            "application/json":
-              schema:
-                $ref: "#/components/schemas/CompiledModel"
-        "401":
-          $ref: "#/components/responses/UnauthorizedError"
-        "404":
-          $ref: "#/components/responses/NotFoundError"
-        "424":
-          $ref: "#/components/responses/ModelCompilationError"
-        "500":
-          $ref: "#/components/responses/InternalServerError"
-        "501":
-          $ref: "#/components/responses/NotImplementedError"
-
-  /projects/{projectName}/packages/{packageName}/notebooks:
-    get:
-      tags:
-        - notebooks
-      operationId: list-notebooks
-      summary: Returns a list of relative paths to the notebooks in the package.
-      parameters:
-        - name: projectName
-          in: path
-          description: Name of project
-          required: true
-          schema:
-            type: string
-        - name: packageName
-          in: path
-          description: Name of package
-          required: true
-          schema:
-            type: string
-        - name: versionId
-          in: query
-          description: Version ID
-          required: false
-          schema:
-            type: string
-      responses:
-        "200":
-          description: A list of relative paths to the models in the package.
-          content:
-            application/json:
-              schema:
-                type: array
-                items:
-                  $ref: "#/components/schemas/Notebook"
-        "401":
-          $ref: "#/components/responses/UnauthorizedError"
-        "404":
-          $ref: "#/components/responses/NotFoundError"
-        "500":
-          $ref: "#/components/responses/InternalServerError"
-        "501":
-          $ref: "#/components/responses/NotImplementedError"
-
-  /projects/{projectName}/packages/{packageName}/notebooks/{path}:
-    get:
-      tags:
-        - notebooks
-      operationId: get-notebook
-      summary: Returns a Malloy notebook.
-      parameters:
-        - name: projectName
-          in: path
-          description: Name of project
-          required: true
-          schema:
-            type: string
-        - name: packageName
-          in: path
-          description: Name of package.
-          required: true
-          schema:
-            type: string
-        - name: path
-          in: path
-          description: Path to notebook wihin the package.
-          required: true
-          schema:
-            type: string
-        - name: versionId
-          in: query
-          description: Version ID
-          required: false
-          schema:
-            type: string
-      responses:
-        "200":
-          description: A Malloy notebook.
-          content:
-            "application/json":
-              schema:
-                $ref: "#/components/schemas/CompiledNotebook"
-        "401":
-          $ref: "#/components/responses/UnauthorizedError"
-        "404":
-          $ref: "#/components/responses/NotFoundError"
-        "500":
-          $ref: "#/components/responses/InternalServerError"
-        "501":
-          $ref: "#/components/responses/NotImplementedError"
-
-  /projects/{projectName}/packages/{packageName}/queryResults/{path}:
-    get:
-      tags:
-        - queryresults
-      operationId: execute-query
-      summary: Returns a query and its results.
-      parameters:
-        - name: projectName
-          in: path
-          description: Name of project
-          required: true
-          schema:
-            type: string
-        - name: packageName
-          in: path
-          description: Name of package
-          required: true
-          schema:
-            type: string
-        - name: path
-          in: path
-          description: Path to model within the package.
-          required: true
-          schema:
-            type: string
-        - in: query
-          name: query
-          description: Query string to execute on the model.  If the query is paramter is set, the queryName parameter must be empty.
-          required: false
-          schema:
-            type: string
-        - in: query
-          name: sourceName
-          description: Name of the source in the model to use for queryName, search, and topValue requests.
-          required: false
-          schema:
-            type: string
-        - in: query
-          name: queryName
-          description: Name of a query to execute on a source in the model.  Requires the sourceName parameter is set.  If the queryName is paramter is set, the query parameter must be empty.
-          required: false
-          schema:
-            type: string
-        - in: query
-          name: versionId
-          description: Version ID
-          required: false
-          schema:
-            type: string
-      responses:
-        "200":
-          description: A query and its results.
-          content:
-            "application/json":
-              schema:
-                $ref: "#/components/schemas/QueryResult"
-        "400":
-          $ref: "#/components/responses/BadRequestError"
-        "401":
-          $ref: "#/components/responses/UnauthorizedError"
-        "404":
-          $ref: "#/components/responses/NotFoundError"
-        "500":
-          $ref: "#/components/responses/InternalServerError"
-        "501":
-          $ref: "#/components/responses/NotImplementedError"
-
-  /projects/{projectName}/packages/{packageName}/databases:
-    get:
-      tags:
-        - databases
-      operationId: list-databases
-      summary: Returns a list of relative paths to the databases embedded in the package.
-      parameters:
-        - name: projectName
-          in: path
-          description: Name of project
-          required: true
-          schema:
-            type: string
-        - name: packageName
-          in: path
-          description: Name of package
-          required: true
-          schema:
-            type: string
-        - name: versionId
-          in: query
-          description: Version ID
-          required: false
-          schema:
-            type: string
-      responses:
-        "200":
-          description: A list of relative paths to the databases embedded in the package.
-          content:
-            application/json:
-              schema:
-                type: array
-                items:
-                  $ref: "#/components/schemas/Database"
-        "401":
-          $ref: "#/components/responses/UnauthorizedError"
-        "404":
-          $ref: "#/components/responses/NotFoundError"
-        "500":
-          $ref: "#/components/responses/InternalServerError"
-        "501":
-          $ref: "#/components/responses/NotImplementedError"
-
-  /projects/{projectName}/packages/{packageName}/schedules:
-    get:
-      tags:
-        - schedules
-      operationId: list-schedules
-      summary: Returns a list of running schedules.
-      parameters:
-        - name: projectName
-          in: path
-          description: Name of project
-          required: true
-          schema:
-            type: string
-        - name: packageName
-          in: path
-          description: Name of package
-          required: true
-          schema:
-            type: string
-        - name: versionId
-          in: query
-          description: Version ID
-          required: false
-          schema:
-            type: string
-      responses:
-        "200":
-          description: A list of running schedules.
-          content:
-            application/json:
-              schema:
-                type: array
-                items:
-                  $ref: "#/components/schemas/Schedule"
-        "401":
-          $ref: "#/components/responses/UnauthorizedError"
-        "404":
-          $ref: "#/components/responses/NotFoundError"
-        "500":
-          $ref: "#/components/responses/InternalServerError"
-        "501":
-          $ref: "#/components/responses/NotImplementedError"
-
-components:
-  responses:
-    InternalServerError:
-      description: The server encountered an internal error
-      content:
-        application/json:
-          schema:
-            $ref: "#/components/schemas/Error"
-    NotFoundError:
-      description: The specified resource was not found
-      content:
-        application/json:
-          schema:
-            $ref: "#/components/schemas/Error"
-    NotImplementedError:
-      description: Not implemented
-      content:
-        application/json:
-          schema:
-            $ref: "#/components/schemas/Error"
-    UnauthorizedError:
-      description: Unauthorized
-      content:
-        application/json:
-          schema:
-            $ref: "#/components/schemas/Error"
-    BadRequestError:
-      description: Bad request
-      content:
-        application/json:
-          schema:
-            $ref: "#/components/schemas/Error"
-    ModelCompilationError:
-      description: Model compilation error
-      content:
-        application/json:
-          schema:
-            $ref: "#/components/schemas/Error"
-
-  schemas:
-    About:
-      type: object
-      properties:
-        readme:
-          type: string
-          description: Readme markdown.
-
-    Project:
-      type: object
-      properties:
-        resource:
-          type: string
-          description: Resource path to the project.
-        name:
-          type: string
-          description: Project name.
-        readme:
-          type: string
-          description: Project readme.
-
-    Package:
-      type: object
-      properties:
-        resource:
-          type: string
-          description: Resource path to the package.
-        name:
-          type: string
-          description: Package name.
-        description:
-          type: string
-          description: Package description.
-
-    Model:
-      type: object
-      description: Malloy Model metadata
-      properties:
-        resource:
-          type: string
-          description: Resource path to the model.
-        packageName:
-          type: string
-          description: Model's package Name
-        path:
-          type: string
-          description: Model's relative path in its package directory.
-        error: 
-          type: string
-          description: Error message for this model object.
-
-    Notebook:
-      type: object
-      description: Malloy Notebook metadata
-      properties:
-        resource:
-          type: string
-          description: Resource path to the notebook.
-        packageName:
-          type: string
-          description: Notebook's package Name
-        path:
-          type: string
-          description: Notebook's relative path in its package directory.
-        error: 
-          type: string
-          description: Error message for this notebook object.
-
-    CompiledNotebook:
-      type: object
-      description: Malloy notebook def and result data.  Malloy notebook def and result data is Malloy version depdendent.
-      properties:
-        resource:
-          type: string
-          description: Resource path to the notebook.
-        packageName:
-          type: string
-          description: Notebook's package Name
-        path:
-          type: string
-          description: Notebook's relative path in its package directory.
-        malloyVersion:
-          type: string
-          description: Version of the Malloy compiler that generated the notebook def and results fields.
-        notebookCells:
-          type: array
-          description: Array of notebook cells.
-          items:
-            $ref: "#/components/schemas/NotebookCell"
-
-    CompiledModel:
-      type: object
-      description: Malloy model def and result data.  Malloy model def and result data is Malloy version depdendent.
-      properties:
-        resource:
-          type: string
-          description: Resource path to the model.
-        packageName:
-          type: string
-          description: Model's package Name
-        path:
-          type: string
-          description: Model's relative path in its package directory.
-        malloyVersion:
-          type: string
-          description: Version of the Malloy compiler that generated the model def and results fields.
-        modelInfo:
-          type: string
-          description: JSON string of ModelInfo. See malloy/packages/malloy-interfaces/src/types.ts
-        sourceInfos:
-          type: array
-          description: Array of JSON string of SourceInfo. See malloy/packages/malloy-interfaces/src/types.ts
-          items:
-            type: string
-        queries:
-          type: array
-          descript: Array of named queries.
-          items:
-            $ref: "#/components/schemas/Query"
-
-    View:
-      type: object
-      description: Named model view.
-      properties:
-        name:
-          type: string
-          description: View's name.
-        annotations:
-          type: array
-          description: Annotations attached to view.
-          items:
-            type: string
-
-    Query:
-      type: object
-      description: Named model query.
-      properties:
-        name:
-          type: string
-          description: Query's name.
-        sourceName:
-          type: string
-          description: Source name.
-        annotations:
-          type: array
-          description: Annotations attached to query.
-          items:
-            type: string
-
-    NotebookCell:
-      type: object
-      description: Notebook cell.
-      properties:
-        type:
-          type: string
-          enum: ["markdown", "code"]
-          description: Type of notebook cell.
-        text:
-          type: string
-          description: Text contents of the notebook cell.
-        result:
-          type: string
-          description: JSON string of Malloy.Result. See malloy/packages/malloy-interfaces/src/types.ts
-        newSources:
-          type: array
-          description:
-            Array of JSON string of SourceInfo made available in the notebook cell. Only *new*
-            SourceInfos are returned. The complete list of SourceInfos is available be concatenating the prior
-            notebook cells.  The SourceInfos are in the order they are made available in the notebook cell.
-          items:
-            type: string
-
-    QueryResult:
-      type: object
-      description: A Malloy query's results.
-      properties:
-        result:
-          type: string
-          description: JSON string of Malloy.Result. See malloy/packages/malloy-interfaces/src/types.ts
-        resource:
-          type: string
-          description: Resource path to the query result.
-
-    Database:
-      type: object
-      description: An in-memory DuckDB database embedded in the package.
-      properties:
-        resource:
-          type: string
-          description: Resource path to the database.
-        path:
-          type: string
-          description: Database's relative path in its package directory.
-        info:
-          $ref: "#/components/schemas/TableDescription"
-        type:
-          type: string
-          enum: ["embedded", "materialized"]
-          description: Type of database.
-
-    Schedule:
-      type: object
-      description: A scheduled task.
-      properties:
-        resource:
-          type: string
-          description: Resource in the package that the schedule is attached to.
-        schedule:
-          type: string
-          description: Schedule (cron format) for executing task.
-        action:
-          type: string
-          description: Action to execute.
-        connection:
-          type: string
-          description: Connection to perform action on.
-        lastRunTime:
-          type: number
-          description: Timestamp in milliseconds of the last run.
-        lastRunStatus:
-          type: string
-          description: Status of the last run.
-
-    SchemaName:
-      description: A schema name in a Connection.
-      type: object
-      properties:
-        name:
-          type: string
-          description: Name of the schema
-        isDefault:
-          type: boolean
-          description: Whether this schema is the default schema
-        isHidden:
-          type: boolean
-          description: Whether this schema is hidden
-
-    Connection:
-      type: object
-      properties:
-        resource:
-          type: string
-          description: Resource path to the connection.
-        name:
-          type: string
-        type:
-          type: string
-          enum: [postgres, bigquery, snowflake, trino]
-        attributes:
-          $ref: "#/components/schemas/ConnectionAttributes"
-        postgresConnection:
-          $ref: "#/components/schemas/PostgresConnection"
-        bigqueryConnection:
-          $ref: "#/components/schemas/BigqueryConnection"
-        snowflakeConnection:
-          $ref: "#/components/schemas/SnowflakeConnection"
-        trinoConnection:
-          $ref: "#/components/schemas/TrinoConnection"
-
-    ConnectionAttributes:
-      type: object
-      properties:
-        dialectName:
-          type: string
-        isPool:
-          type: boolean
-        canPersist:
-          type: boolean
-        canStream:
-          type: boolean
-
-    PostgresConnection:
-      type: object
-      properties:
-        host:
-          type: string
-        port:
-          type: integer
-        databaseName:
-          type: string
-        userName:
-          type: string
-        password:
-          type: string
-        connectionString:
-          type: string
-
-    BigqueryConnection:
-      type: object
-      properties:
-        defaultProjectId:
-          type: string
-        billingProjectId:
-          type: string
-        location:
-          type: string
-        serviceAccountKeyJson:
-          type: string
-        maximumBytesBilled:
-          type: string
-        queryTimeoutMilliseconds:
-          type: string
-
-    SnowflakeConnection:
-      type: object
-      properties:
-        account:
-          type: string
-        username:
-          type: string
-        password:
-          type: string
-        warehouse:
-          type: string
-        database:
-          type: string
-        schema:
-          type: string
-        responseTimeoutMilliseconds:
-          type: integer
-
-    TrinoConnection:
-      type: object
-      properties:
-        server:
-          type: string
-        port:
-          type: number
-        catalog:
-          type: string
-        schema:
-          type: string
-        user:
-          type: string
-        password:
-          type: string
-
-    SqlSource:
-      type: object
-      properties:
-        resource:
-          type: string
-          description: Resource path to the sql source.
-        # Pass source as an opaque JSON string that is malloyVersion depdendent.
-        source:
-          type: string
-
-    TableSource:
-      type: object
-      properties:
-        resource:
-          type: string
-          description: Resource path to the table source.
-        # Pass source as an opaque JSON string that is malloyVersion depdendent.
-        # TODO: Remove this once we update the Malloy Publisher connection.
-        source:
-          type: string
-        columns:
-          description: Table fields
-          type: array
-          items:
-            $ref: "#/components/schemas/Column"
-
-    TemporaryTable:
-      type: object
-      properties:
-        resource:
-          type: string
-          description: Resource path to the temporary table.
-        # Pass table as an opaque JSON string that is malloyVersion depdendent.
-        table:
-          type: string
-
-    QueryData:
-      type: object
-      properties:
-        resource:
-          type: string
-          description: Resource path to the query data.
-        # Pass result as an opaque JSON string that is malloyVersion depdendent.
-        data:
-          type: string
-
-    Error:
-      type: object
-      properties:
-        code:
-          type: integer
-        message:
-          type: string
-
-    Column:
-      type: object
-      properties:
-        name:
-          type: string
-        type:
-          type: string
-
-    TableDescription:
-      type: object
-      properties:
-        name:
-          type: string
-        rowCount:
-          type: integer
-        columns:
-          type: array
-          items:
-            $ref: "#/components/schemas/Column"