@cfworker/cosmos 1.12.2 → 1.13.0

package/README.md

@@ -44,10 +44,14 @@ import { CosmosClient } from '@cfworker/cosmos';
 
 // 🚨️ Do not commit your Cosmos DB master key to source control!
 // Use a bundler like Rollup, Parcel, or Webpack to interpolate your master key at build-time.
-const masterKey = '...top secret master key copied from the azure portal...';
+const accountKey = '...top secret master key copied from the azure portal...';
 const endpoint = 'https://xxxxxxxxxxxx.documents.azure.com';
 
-const client = new CosmosClient({ endpoint, masterKey });
+const client = new CosmosClient({ endpoint, accountKey });
+
+// or
+
+const client = new CosmosClient({ connectionString });
 ```
 
 ### Specify consistency level
@@ -58,7 +62,7 @@ You may override the default value when constructing the CosmosClient.
 ```ts
 const consistencyLevel = 'Eventual';
 
-const client = new CosmosClient({ endpoint, masterKey, consistencyLevel });
+const client = new CosmosClient({ endpoint, accountKey, consistencyLevel });
 ```
 
 Most methods on CosmosClient accept a `consistencyLevel` argument to enable overriding the client's consistency level on a case-by-case basis.
@@ -76,7 +80,7 @@ You may specify default values for these arguments when constructing the CosmosC
 const dbId = 'my-db';
 const collId = 'my-coll';
 
-const client = new CosmosClient({ endpoint, masterKey, dbId, collId });
+const client = new CosmosClient({ endpoint, accountKey, dbId, collId });
 ```
 
 ### Authenticating with resource tokens

package/dist/client.d.ts

@@ -1,10 +1,11 @@
 import { FeedResponse, ItemResponse } from './response.js';
 import { RetryPolicy } from './retry.js';
 import { SessionContainer } from './session.js';
-import { Collection, ConsistencyLevel, Database, Document, IndexingDirective, IndexingPolicy, OfferType, PartitionKeyDefinition, Resource } from './types.js';
-export interface CosmosClientConfig {
-    endpoint: string;
-    masterKey: string;
+import { Collection, ConnectionInfo, ConsistencyLevel, Database, Document, IndexingDirective, IndexingPolicy, OfferType, PartitionKeyDefinition, Resource } from './types.js';
+export declare type CosmosClientConfig = (ConnectionInfo & CosmosClientConfigBase) | ({
+    connectionString: string;
+} & CosmosClientConfigBase);
+interface CosmosClientConfigBase {
     retryPolicy?: RetryPolicy;
     consistencyLevel?: ConsistencyLevel;
     dbId?: string;

package/dist/client.js

@@ -2,13 +2,19 @@ import { FeedResponse, ItemResponse } from './response.js';
 import { defaultRetryPolicy } from './retry.js';
 import { DefaultSessionContainer } from './session.js';
 import { getSigner } from './signer.js';
-import { assertArg, escapeNonASCII, uri } from './util.js';
+import { assertArg, escapeNonASCII, parseConnectionString, uri } from './util.js';
 export class CosmosClient {
     constructor(config) {
         this.requestCharges = 0;
         this.retries = { count: 0, delayMs: 0 };
-        this.endpoint = config.endpoint;
-        this.signer = getSigner(config.masterKey);
+        let { endpoint, accountKey } = 'connectionString' in config
+            ? parseConnectionString(config.connectionString)
+            : config;
+        if (endpoint.endsWith('/')) {
+            endpoint = endpoint.slice(0, -1);
+        }
+        this.endpoint = endpoint;
+        this.signer = getSigner(accountKey);
         this.retryPolicy = config.retryPolicy ?? defaultRetryPolicy;
         this.consistencyLevel = config.consistencyLevel ?? 'Session';
         this.dbId = config.dbId;
@@ -16,7 +22,7 @@ export class CosmosClient {
         this.enableCrossPartitionQueries =
             config.enableCrossPartitionQueries ?? true;
         this.sessions = config.sessions ?? new DefaultSessionContainer();
-        this.systemFetch = config.fetch ?? fetch.bind(self);
+        this.systemFetch = config.fetch ?? fetch.bind(globalThis);
     }
     async getDatabases(args = {}) {
         const url = this.endpoint + `/dbs`;

package/dist/signer.d.ts

@@ -9,4 +9,4 @@ export declare class Signer {
         resourceId: string;
     };
 }
-export declare function getSigner(masterkey: string): Signer;
+export declare function getSigner(accountKey: string): Signer;

package/dist/signer.js

@@ -35,9 +35,9 @@ export class Signer {
     }
 }
 const signers = {};
-export function getSigner(masterkey) {
-    if (!signers[masterkey]) {
-        signers[masterkey] = new Signer(masterkey);
+export function getSigner(accountKey) {
+    if (!signers[accountKey]) {
+        signers[accountKey] = new Signer(accountKey);
     }
-    return signers[masterkey];
+    return signers[accountKey];
 }

package/dist/types.d.ts

@@ -56,3 +56,7 @@ export interface Collection extends PersistedResource {
     _udfs: 'udfs/';
     _conflicts: 'conflicts/';
 }
+export interface ConnectionInfo {
+    endpoint: string;
+    accountKey: string;
+}

package/dist/util.d.ts

@@ -1,3 +1,5 @@
+import { ConnectionInfo } from './types';
 export declare function escapeNonASCII(s: string): string;
 export declare function assertArg(name: string, value: any): asserts value;
 export declare function uri(strings: TemplateStringsArray, ...values: any[]): string;
+export declare function parseConnectionString(connString: string): ConnectionInfo;

package/dist/util.js

@@ -13,3 +13,24 @@ export function uri(strings, ...values) {
     }
     return s;
 }
+export function parseConnectionString(connString) {
+    const props = {};
+    connString.split(';').forEach(kv => {
+        const pos = kv.indexOf('=');
+        if (pos < 1) {
+            return;
+        }
+        const key = kv.slice(0, pos);
+        const val = kv.slice(pos + 1);
+        if (key && val) {
+            props[key] = val;
+        }
+    });
+    if (!props.AccountEndpoint || !props.AccountKey) {
+        throw new Error('Invalid connection string');
+    }
+    return {
+        endpoint: props.AccountEndpoint,
+        accountKey: props.AccountKey
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cfworker/cosmos",
-  "version": "1.12.2",
+  "version": "1.13.0",
   "description": "Azure Cosmos DB client for Cloudflare Workers and service workers",
   "keywords": [
     "azure",

package/src/client.ts

@@ -4,6 +4,7 @@ import { DefaultSessionContainer, SessionContainer } from './session.js';
 import { getSigner, Signer } from './signer.js';
 import {
   Collection,
+  ConnectionInfo,
   ConsistencyLevel,
   Database,
   Document,
@@ -13,21 +14,25 @@ import {
   PartitionKeyDefinition,
   Resource
 } from './types.js';
-import { assertArg, escapeNonASCII, uri } from './util.js';
-
-export interface CosmosClientConfig {
-  /**
-   * Cosmos DB endpoint.
-   * @example
-   * "https://xxxxxxxxxx.documents.azure.com"
-   */
-  endpoint: string;
-
-  /**
-   * Cosmos DB master key.
-   */
-  masterKey: string;
-
+import {
+  assertArg,
+  escapeNonASCII,
+  parseConnectionString,
+  uri
+} from './util.js';
+
+export type CosmosClientConfig =
+  | (ConnectionInfo & CosmosClientConfigBase)
+  | ({
+      /**
+       * Cosmos DB connection string.
+       * @example
+       * "AccountEndpoint=https://xxxxxxxxxx.documents.azure.com:443/;accountKey=xxxxxxxxxx;"
+       */
+      connectionString: string;
+    } & CosmosClientConfigBase);
+
+interface CosmosClientConfigBase {
   /**
    * The retry policy to use when requests are throttled.
    */
@@ -79,8 +84,15 @@ export class CosmosClient {
   public retries = { count: 0, delayMs: 0 };
 
   constructor(config: CosmosClientConfig) {
-    this.endpoint = config.endpoint;
-    this.signer = getSigner(config.masterKey);
+    let { endpoint, accountKey } =
+      'connectionString' in config
+        ? parseConnectionString(config.connectionString)
+        : config;
+    if (endpoint.endsWith('/')) {
+      endpoint = endpoint.slice(0, -1);
+    }
+    this.endpoint = endpoint;
+    this.signer = getSigner(accountKey);
     this.retryPolicy = config.retryPolicy ?? defaultRetryPolicy;
     this.consistencyLevel = config.consistencyLevel ?? 'Session';
     this.dbId = config.dbId;
@@ -88,7 +100,7 @@ export class CosmosClient {
     this.enableCrossPartitionQueries =
       config.enableCrossPartitionQueries ?? true;
     this.sessions = config.sessions ?? new DefaultSessionContainer();
-    this.systemFetch = config.fetch ?? fetch.bind(self);
+    this.systemFetch = config.fetch ?? fetch.bind(globalThis);
   }
 
   public async getDatabases(

package/src/signer.ts

@@ -55,9 +55,9 @@ export class Signer {
 
 const signers: Record<string, Signer> = {};
 
-export function getSigner(masterkey: string) {
-  if (!signers[masterkey]) {
-    signers[masterkey] = new Signer(masterkey);
+export function getSigner(accountKey: string) {
+  if (!signers[accountKey]) {
+    signers[accountKey] = new Signer(accountKey);
   }
-  return signers[masterkey];
+  return signers[accountKey];
 }

package/src/types.ts

@@ -66,3 +66,17 @@ export interface Collection extends PersistedResource {
   _udfs: 'udfs/';
   _conflicts: 'conflicts/';
 }
+
+export interface ConnectionInfo {
+  /**
+   * Cosmos DB endpoint.
+   * @example
+   * "https://xxxxxxxxxx.documents.azure.com"
+   */
+  endpoint: string;
+
+  /**
+   * Cosmos DB key.
+   */
+  accountKey: string;
+}

package/src/util.ts

@@ -1,3 +1,5 @@
+import { ConnectionInfo } from './types';
+
 /**
  * Escape non-ASCII characters as \uXXXX
  */
@@ -29,3 +31,29 @@ export function uri(strings: TemplateStringsArray, ...values: any[]) {
   }
   return s;
 }
+
+/**
+ * Parses a connection string for Cosmos DB.
+ * @param connString Cosmos DB connection string.
+ */
+export function parseConnectionString(connString: string): ConnectionInfo {
+  const props: Record<string, string> = {};
+  connString.split(';').forEach(kv => {
+    const pos = kv.indexOf('=');
+    if (pos < 1) {
+      return;
+    }
+    const key = kv.slice(0, pos);
+    const val = kv.slice(pos + 1);
+    if (key && val) {
+      props[key] = val;
+    }
+  });
+  if (!props.AccountEndpoint || !props.AccountKey) {
+    throw new Error('Invalid connection string');
+  }
+  return {
+    endpoint: props.AccountEndpoint,
+    accountKey: props.AccountKey
+  };
+}