UNPKG

triplecheck-repository-cosmosdb-sql

Version:

![TripleCheck database repository](readme/triplecheck-repository.png)

166 lines (157 loc) 13.6 kB
<!doctype html> <html class="default no-js"> <head> <meta charset="utf-8"> <meta http-equiv="X-UA-Compatible" content="IE=edge"> <title>triplecheck-repository-cosmosdb-sql</title> <meta name="description" content="Documentation for triplecheck-repository-cosmosdb-sql"> <meta name="viewport" content="width=device-width, initial-scale=1"> <link rel="stylesheet" href="assets/css/main.css"> <script async src="assets/js/search.js" id="search-script"></script> </head> <body> <header> <div class="tsd-page-toolbar"> <div class="container"> <div class="table-wrap"> <div class="table-cell" id="tsd-search" data-index="assets/js/search.json" data-base="."> <div class="field"> <label for="tsd-search-field" class="tsd-widget search no-caption">Search</label> <input id="tsd-search-field" type="text" /> </div> <ul class="results"> <li class="state loading">Preparing search index...</li> <li class="state failure">The search index is not available</li> </ul> <a href="index.html" class="title">triplecheck-repository-cosmosdb-sql</a> </div> <div class="table-cell" id="tsd-widgets"> <div id="tsd-filter"> <a href="#" class="tsd-widget options no-caption" data-toggle="options">Options</a> <div class="tsd-filter-group"> <div class="tsd-select" id="tsd-filter-visibility"> <span class="tsd-select-label">All</span> <ul class="tsd-select-list"> <li data-value="public">Public</li> <li data-value="protected">Public/Protected</li> <li data-value="private" class="selected">All</li> </ul> </div> <input type="checkbox" id="tsd-filter-inherited" checked /> <label class="tsd-widget" for="tsd-filter-inherited">Inherited</label> <input type="checkbox" id="tsd-filter-externals" checked /> <label class="tsd-widget" for="tsd-filter-externals">Externals</label> </div> </div> <a href="#" class="tsd-widget menu no-caption" data-toggle="menu">Menu</a> </div> </div> </div> </div> <div class="tsd-page-title"> <div class="container"> <h1>triplecheck-repository-cosmosdb-sql</h1> </div> </div> </header> <div class="container container-main"> <div class="row"> <div class="col-8 col-content"> <div class="tsd-panel tsd-typography"> <a href="#triplecheck-repository-cosmosdb-sql" id="triplecheck-repository-cosmosdb-sql" style="color: inherit; text-decoration: none;"> <h1>triplecheck-repository-cosmosdb-sql</h1> </a> <p><img src="readme/triplecheck-repository.png" alt="TripleCheck database repository"></p> <a href="#triplecheck-azure-cosmosdb-sql-database-repository" id="triplecheck-azure-cosmosdb-sql-database-repository" style="color: inherit; text-decoration: none;"> <h2>TripleCheck: Azure CosmosDB (SQL) database repository</h2> </a> <p>Database utility for using CosmosDB (SQL) with TripleCheck broker.</p> <a href="#instructions" id="instructions" style="color: inherit; text-decoration: none;"> <h2>Instructions</h2> </a> <p>You&#39;ll need to have a CosmosDB account up, a container (SQL) and set the Partition Key to <code>/id</code>. Also, I&#39;d recommend maybe setting the consistency to &quot;Strong&quot;. Consider using the serverless option for CosmosDB, since that will be a lot cheaper for smaller workloads.</p> <a href="#basic-implementation" id="basic-implementation" style="color: inherit; text-decoration: none;"> <h2>Basic implementation</h2> </a> <p>In your <code>triplecheck-broker</code> implementation, do a regular import for <code>triplecheck-repository-cosmosdbsql</code> and pass the repository to the broker. In an Azure Functions context, an implementation could look like:</p> <pre><code class="language-TypeScript"><span style="color: #AF00DB">import</span><span style="color: #000000"> { </span><span style="color: #001080">TripleCheckBroker</span><span style="color: #000000"> } </span><span style="color: #AF00DB">from</span><span style="color: #000000"> </span><span style="color: #A31515">&#039;triplecheck-broker&#039;</span><span style="color: #000000">;</span> <span style="color: #AF00DB">import</span><span style="color: #000000"> { </span><span style="color: #001080">CosmosSqlRepository</span><span style="color: #000000"> } </span><span style="color: #AF00DB">from</span><span style="color: #000000"> </span><span style="color: #A31515">&#039;triplecheck-repository-cosmosdb-sql&#039;</span><span style="color: #000000">;</span> <span style="color: #AF00DB">export</span><span style="color: #000000"> </span><span style="color: #0000FF">const</span><span style="color: #000000"> </span><span style="color: #0070C1">config</span><span style="color: #000000"> = {</span> <span style="color: #000000"> </span><span style="color: #001080">endpoint:</span><span style="color: #000000"> </span><span style="color: #A31515">&#039;&lt;your_endpoint_uri&gt;&#039;</span><span style="color: #000000">,</span> <span style="color: #000000"> </span><span style="color: #001080">key:</span><span style="color: #000000"> </span><span style="color: #A31515">&#039;&lt;primary_key&gt;&#039;</span><span style="color: #000000">,</span> <span style="color: #000000"> </span><span style="color: #001080">databaseId:</span><span style="color: #000000"> </span><span style="color: #A31515">&#039;triplecheck&#039;</span><span style="color: #000000">, </span><span style="color: #008000">// &lt;--- example</span> <span style="color: #000000"> </span><span style="color: #001080">containerId:</span><span style="color: #000000"> </span><span style="color: #A31515">&#039;broker_sql&#039;</span><span style="color: #000000"> </span><span style="color: #008000">// &lt;--- example</span> <span style="color: #000000">};</span> <span style="color: #008000">/**</span> <span style="color: #008000"> * </span><span style="color: #0000FF">@description</span><span style="color: #008000"> The handler.</span> <span style="color: #008000"> */</span> <span style="color: #AF00DB">export</span><span style="color: #000000"> </span><span style="color: #0000FF">async</span><span style="color: #000000"> </span><span style="color: #0000FF">function</span><span style="color: #000000"> </span><span style="color: #795E26">handler</span><span style="color: #000000">(</span><span style="color: #001080">context</span><span style="color: #000000">: </span><span style="color: #267F99">any</span><span style="color: #000000">, </span><span style="color: #001080">req</span><span style="color: #000000">: </span><span style="color: #267F99">any</span><span style="color: #000000">) {</span> <span style="color: #000000"> </span><span style="color: #0000FF">const</span><span style="color: #000000"> [</span><span style="color: #0070C1">request</span><span style="color: #000000">, </span><span style="color: #0070C1">payload</span><span style="color: #000000">] = </span><span style="color: #AF00DB">await</span><span style="color: #000000"> </span><span style="color: #795E26">getRequestData</span><span style="color: #000000">(</span><span style="color: #001080">req</span><span style="color: #000000">);</span> <span style="color: #000000"> </span><span style="color: #0000FF">const</span><span style="color: #000000"> </span><span style="color: #0070C1">repository</span><span style="color: #000000"> = </span><span style="color: #795E26">CosmosSqlRepository</span><span style="color: #000000">(</span><span style="color: #001080">config</span><span style="color: #000000">);</span> <span style="color: #000000"> </span><span style="color: #0000FF">const</span><span style="color: #000000"> { </span><span style="color: #0070C1">responseData</span><span style="color: #000000">, </span><span style="color: #0070C1">status</span><span style="color: #000000">, </span><span style="color: #0070C1">headers</span><span style="color: #000000"> } = </span><span style="color: #AF00DB">await</span><span style="color: #000000"> </span><span style="color: #795E26">TripleCheckBroker</span><span style="color: #000000">(</span><span style="color: #001080">request</span><span style="color: #000000">, </span><span style="color: #001080">payload</span><span style="color: #000000">, </span><span style="color: #001080">repository</span><span style="color: #000000">);</span> <span style="color: #000000"> </span><span style="color: #AF00DB">return</span><span style="color: #000000"> {</span> <span style="color: #000000"> </span><span style="color: #001080">status</span><span style="color: #000000">,</span> <span style="color: #000000"> </span><span style="color: #001080">body:</span><span style="color: #000000"> </span><span style="color: #001080">responseData</span> <span style="color: #000000"> };</span> <span style="color: #000000">}</span> <span style="color: #008000">/**</span> <span style="color: #008000"> * </span><span style="color: #0000FF">@description</span><span style="color: #008000"> Utility function to get the data we need to run the TripleCheck broker. Expects the full Azure Functions request object.</span> <span style="color: #008000"> */</span> <span style="color: #0000FF">async</span><span style="color: #000000"> </span><span style="color: #0000FF">function</span><span style="color: #000000"> </span><span style="color: #795E26">getRequestData</span><span style="color: #000000">(</span><span style="color: #001080">req</span><span style="color: #000000">: </span><span style="color: #267F99">any</span><span style="color: #000000">) {</span> <span style="color: #000000"> </span><span style="color: #0000FF">const</span><span style="color: #000000"> { </span><span style="color: #0070C1">body</span><span style="color: #000000">, </span><span style="color: #0070C1">method</span><span style="color: #000000">, </span><span style="color: #0070C1">url</span><span style="color: #000000"> } = </span><span style="color: #001080">req</span><span style="color: #000000">;</span> <span style="color: #000000"> </span><span style="color: #0000FF">let</span><span style="color: #000000"> [</span><span style="color: #001080">pathname</span><span style="color: #000000">, </span><span style="color: #001080">search</span><span style="color: #000000">] = </span><span style="color: #001080">url</span><span style="color: #000000">.</span><span style="color: #795E26">split</span><span style="color: #000000">(</span><span style="color: #A31515">&#039;?&#039;</span><span style="color: #000000">);</span> <span style="color: #000000"> </span><span style="color: #AF00DB">if</span><span style="color: #000000"> (!</span><span style="color: #001080">pathname</span><span style="color: #000000">) </span><span style="color: #001080">pathname</span><span style="color: #000000"> = </span><span style="color: #001080">url</span><span style="color: #000000">;</span> <span style="color: #000000"> </span><span style="color: #0000FF">const</span><span style="color: #000000"> </span><span style="color: #0070C1">payload</span><span style="color: #000000"> = </span><span style="color: #0000FF">typeof</span><span style="color: #000000"> </span><span style="color: #001080">body</span><span style="color: #000000"> === </span><span style="color: #A31515">&#039;string&#039;</span><span style="color: #000000"> ? </span><span style="color: #267F99">JSON</span><span style="color: #000000">.</span><span style="color: #795E26">parse</span><span style="color: #000000">(</span><span style="color: #001080">body</span><span style="color: #000000">) : </span><span style="color: #001080">body</span><span style="color: #000000">;</span> <span style="color: #000000"> </span><span style="color: #AF00DB">return</span><span style="color: #000000"> [</span> <span style="color: #000000"> {</span> <span style="color: #000000"> </span><span style="color: #001080">method</span><span style="color: #000000">,</span> <span style="color: #000000"> </span><span style="color: #001080">pathname</span><span style="color: #000000">,</span> <span style="color: #000000"> </span><span style="color: #001080">search</span> <span style="color: #000000"> },</span> <span style="color: #000000"> </span><span style="color: #001080">payload</span> <span style="color: #000000"> ];</span> <span style="color: #000000">}</span> </code></pre> </div> </div> <div class="col-4 col-menu menu-sticky-wrap menu-highlight"> <nav class="tsd-navigation primary"> <ul> <li class=" "> <a href="modules.html">Exports</a> </li> <li class=" tsd-kind-module"> <a href="modules/cosmosdbrepository.html">Cosmos<wbr>DbRepository</a> </li> <li class=" tsd-kind-module"> <a href="modules/frameworks_cleancosmosdbitems.html">frameworks/clean<wbr>Cosmos<wbr>DbItems</a> </li> <li class=" tsd-kind-module"> <a href="modules/index.html">index</a> </li> </ul> </nav> <nav class="tsd-navigation secondary menu-sticky"> <ul class="before-current"> </ul> </nav> </div> </div> </div> <footer class="with-border-bottom"> <div class="container"> <h2>Legend</h2> <div class="tsd-legend-group"> <ul class="tsd-legend"> <li class="tsd-kind-function"><span class="tsd-kind-icon">Function</span></li> </ul> </div> </div> </footer> <div class="container tsd-generator"> <p>Generated using <a href="https://typedoc.org/" target="_blank">TypeDoc</a></p> </div> <div class="overlay"></div> <script src="assets/js/main.js"></script> </body> </html>