@fluidframework/odsp-driver-definitions 2.0.0-dev.7.4.0.217884 → 2.0.0-dev.7.4.0.221926

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (46) hide show
  1. package/CHANGELOG.md +4 -0
  2. package/api-extractor.json +0 -3
  3. package/api-report/odsp-driver-definitions.api.md +24 -24
  4. package/dist/factory.cjs.map +1 -1
  5. package/dist/factory.d.ts +4 -4
  6. package/dist/odsp-driver-definitions-alpha.d.ts +440 -41
  7. package/dist/odsp-driver-definitions-beta.d.ts +4 -0
  8. package/dist/odsp-driver-definitions-public.d.ts +4 -0
  9. package/dist/odsp-driver-definitions-untrimmed.d.ts +24 -24
  10. package/dist/odspCache.cjs.map +1 -1
  11. package/dist/odspCache.d.ts +5 -5
  12. package/dist/resolvedUrl.cjs +3 -3
  13. package/dist/resolvedUrl.cjs.map +1 -1
  14. package/dist/resolvedUrl.d.ts +8 -8
  15. package/dist/sessionProvider.cjs.map +1 -1
  16. package/dist/sessionProvider.d.ts +3 -3
  17. package/dist/tokenFetch.cjs.map +1 -1
  18. package/dist/tokenFetch.d.ts +4 -4
  19. package/lib/errors.d.ts +0 -4
  20. package/lib/errors.d.ts.map +1 -1
  21. package/lib/factory.d.ts +4 -4
  22. package/lib/factory.mjs.map +1 -1
  23. package/lib/index.d.ts +6 -6
  24. package/lib/index.d.ts.map +1 -1
  25. package/lib/odsp-driver-definitions-alpha.d.ts +440 -41
  26. package/lib/odsp-driver-definitions-beta.d.ts +4 -0
  27. package/lib/odsp-driver-definitions-public.d.ts +4 -0
  28. package/lib/odsp-driver-definitions-untrimmed.d.ts +24 -24
  29. package/lib/odspCache.d.ts +5 -5
  30. package/lib/odspCache.d.ts.map +1 -1
  31. package/lib/odspCache.mjs.map +1 -1
  32. package/lib/resolvedUrl.d.ts +8 -8
  33. package/lib/resolvedUrl.d.ts.map +1 -1
  34. package/lib/resolvedUrl.mjs +3 -3
  35. package/lib/resolvedUrl.mjs.map +1 -1
  36. package/lib/sessionProvider.d.ts +3 -3
  37. package/lib/sessionProvider.d.ts.map +1 -1
  38. package/lib/sessionProvider.mjs.map +1 -1
  39. package/lib/tokenFetch.d.ts +4 -4
  40. package/lib/tokenFetch.mjs.map +1 -1
  41. package/package.json +4 -2
  42. package/src/factory.ts +4 -4
  43. package/src/odspCache.ts +5 -5
  44. package/src/resolvedUrl.ts +8 -8
  45. package/src/sessionProvider.ts +3 -3
  46. package/src/tokenFetch.ts +4 -4
@@ -3,7 +3,7 @@ import { IDriverErrorBase } from '@fluidframework/driver-definitions';
3
3
  import { IResolvedUrl } from '@fluidframework/driver-definitions';
4
4
 
5
5
  /**
6
- * @internal
6
+ * @alpha
7
7
  */
8
8
  export declare type CacheContentType = "snapshot" | "ops";
9
9
 
@@ -16,7 +16,7 @@ export declare type CacheContentType = "snapshot" | "ops";
16
16
  export declare function getKeyForCacheEntry(entry: ICacheEntry): string;
17
17
 
18
18
  /**
19
- * @internal
19
+ * @alpha
20
20
  */
21
21
  export declare interface HostStoragePolicy {
22
22
  snapshotOptions?: ISnapshotOptions;
@@ -88,7 +88,7 @@ export declare interface HostStoragePolicy {
88
88
 
89
89
  /**
90
90
  * Cache entry. Identifies file that this entry belongs to, and type of content stored in it.
91
- * @internal
91
+ * @alpha
92
92
  */
93
93
  export declare interface ICacheEntry extends IEntry {
94
94
  /**
@@ -98,7 +98,7 @@ export declare interface ICacheEntry extends IEntry {
98
98
  }
99
99
 
100
100
  /**
101
- * @internal
101
+ * @alpha
102
102
  */
103
103
  export declare interface ICollabSessionOptions {
104
104
  /**
@@ -129,7 +129,7 @@ export declare type IdentityType = "Consumer" | "Enterprise";
129
129
 
130
130
  /**
131
131
  * Cache entry. Identifies file that this entry belongs to, and type of content stored in it.
132
- * @internal
132
+ * @alpha
133
133
  */
134
134
  export declare interface IEntry {
135
135
  /**
@@ -150,7 +150,7 @@ export declare interface IEntry {
150
150
  }
151
151
 
152
152
  /**
153
- * @internal
153
+ * @alpha
154
154
  */
155
155
  export declare interface IFileEntry {
156
156
  /**
@@ -202,7 +202,7 @@ export declare interface IOdspErrorAugmentations {
202
202
  }
203
203
 
204
204
  /**
205
- * @internal
205
+ * @alpha
206
206
  */
207
207
  export declare interface IOdspResolvedUrl extends IResolvedUrl, IOdspUrlParts {
208
208
  type: "fluid";
@@ -233,7 +233,7 @@ export declare interface IOdspResolvedUrl extends IResolvedUrl, IOdspUrlParts {
233
233
  }
234
234
 
235
235
  /**
236
- * @internal
236
+ * @alpha
237
237
  */
238
238
  export declare interface IOdspUrlParts {
239
239
  siteUrl: string;
@@ -242,7 +242,7 @@ export declare interface IOdspUrlParts {
242
242
  }
243
243
 
244
244
  /**
245
- * @internal
245
+ * @alpha
246
246
  */
247
247
  export declare interface IOpsCachingPolicy {
248
248
  /**
@@ -276,7 +276,7 @@ export declare interface IOpsCachingPolicy {
276
276
  * cache implementation that does not survive across sessions. Snapshot entires stored in the
277
277
  * IPersistedCache will be considered stale and removed after 2 days. Read the README for more
278
278
  * information.
279
- * @internal
279
+ * @alpha
280
280
  */
281
281
  export declare interface IPersistedCache {
282
282
  /**
@@ -302,7 +302,7 @@ export declare interface IPersistedCache {
302
302
  /**
303
303
  * An interface that allows a concrete instance of a driver factory to interrogate itself
304
304
  * to find out if it is session aware.
305
- * @internal
305
+ * @alpha
306
306
  */
307
307
  export declare interface IProvideSessionAwareDriverFactory {
308
308
  readonly IRelaySessionAwareDriverFactory: IRelaySessionAwareDriverFactory;
@@ -311,7 +311,7 @@ export declare interface IProvideSessionAwareDriverFactory {
311
311
  /**
312
312
  * An interface that allows a concrete instance of a driver factory to call the `getRelayServiceSessionInfo`
313
313
  * function if it session aware.
314
- * @internal
314
+ * @alpha
315
315
  */
316
316
  export declare interface IRelaySessionAwareDriverFactory extends IProvideSessionAwareDriverFactory {
317
317
  getRelayServiceSessionInfo(resolvedUrl: IResolvedUrl): Promise<ISocketStorageDiscovery | undefined>;
@@ -319,7 +319,7 @@ export declare interface IRelaySessionAwareDriverFactory extends IProvideSession
319
319
 
320
320
  /**
321
321
  * Sharing link data received from the /snapshot api response.
322
- * @internal
322
+ * @alpha
323
323
  */
324
324
  export declare interface ISharingLink extends ISharingLinkKind {
325
325
  webUrl: string;
@@ -328,7 +328,7 @@ export declare interface ISharingLink extends ISharingLinkKind {
328
328
  /**
329
329
  * Defines the permissions scope for a share link requested to be created during the creation the file in ODSP.
330
330
  * Providing these properties to the /snapshot api will also create and return the requested kind of sharing link.
331
- * @internal
331
+ * @alpha
332
332
  */
333
333
  export declare interface ISharingLinkKind {
334
334
  scope: SharingLinkScope;
@@ -336,7 +336,7 @@ export declare interface ISharingLinkKind {
336
336
  }
337
337
 
338
338
  /**
339
- * @internal
339
+ * @alpha
340
340
  */
341
341
  export declare interface ISnapshotOptions {
342
342
  blobs?: number;
@@ -348,7 +348,7 @@ export declare interface ISnapshotOptions {
348
348
 
349
349
  /**
350
350
  * Socket storage discovery api response
351
- * @internal
351
+ * @alpha
352
352
  */
353
353
  export declare interface ISocketStorageDiscovery {
354
354
  id: string;
@@ -512,7 +512,7 @@ export declare type OdspErrorTypes = (typeof OdspErrorTypes)[keyof typeof OdspEr
512
512
 
513
513
  /**
514
514
  * Represents access token fetch options for ODSP resource
515
- * @internal
515
+ * @alpha
516
516
  */
517
517
  export declare interface OdspResourceTokenFetchOptions extends TokenFetchOptions {
518
518
  /** Site url representing ODSP resource location */
@@ -527,7 +527,7 @@ export declare interface OdspResourceTokenFetchOptions extends TokenFetchOptions
527
527
  * Sharing link data created for the ODSP item.
528
528
  * Contains information about either sharing link created while creating a new file or
529
529
  * a redeemable share link created when loading an existing file
530
- * @internal
530
+ * @alpha
531
531
  */
532
532
  export declare interface ShareLinkInfoType {
533
533
  /**
@@ -565,7 +565,7 @@ export declare interface ShareLinkInfoType {
565
565
  /**
566
566
  * @deprecated Use ISharingLinkKind type instead.
567
567
  * Type of shareLink requested/created when creating the file for the first time.
568
- * @internal
568
+ * @alpha
569
569
  */
570
570
  export declare enum ShareLinkTypes {
571
571
  csl = "csl"
@@ -573,7 +573,7 @@ export declare enum ShareLinkTypes {
573
573
 
574
574
  /**
575
575
  * View/edit permission role for a sharing link.
576
- * @internal
576
+ * @alpha
577
577
  */
578
578
  export declare enum SharingLinkRole {
579
579
  view = "view",
@@ -582,7 +582,7 @@ export declare enum SharingLinkRole {
582
582
 
583
583
  /**
584
584
  * Sharing scope of the share links created for a file.
585
- * @internal
585
+ * @alpha
586
586
  */
587
587
  export declare enum SharingLinkScope {
588
588
  organization = "organization",
@@ -603,13 +603,13 @@ export declare const snapshotKey = "snapshot";
603
603
  * @returns If successful, TokenResponse object representing token value along with flag indicating
604
604
  * whether token came from cache. Legacy implementation may return a string for token value;
605
605
  * in this case it should be assumes that fromCache signal is undefined. Null is returned in case of failure.
606
- * @internal
606
+ * @alpha
607
607
  */
608
608
  export declare type TokenFetcher<T> = (options: T) => Promise<string | TokenResponse | null>;
609
609
 
610
610
  /**
611
611
  * Represents access token fetch options
612
- * @internal
612
+ * @alpha
613
613
  */
614
614
  export declare interface TokenFetchOptions {
615
615
  /**
@@ -640,7 +640,7 @@ export declare const tokenFromResponse: (tokenResponse: string | TokenResponse |
640
640
 
641
641
  /**
642
642
  * Represents token response
643
- * @internal
643
+ * @alpha
644
644
  */
645
645
  export declare interface TokenResponse {
646
646
  /** Token value */
@@ -9,11 +9,11 @@ import { IResolvedUrl } from "@fluidframework/driver-definitions";
9
9
  */
10
10
  export declare const snapshotKey = "snapshot";
11
11
  /**
12
- * @internal
12
+ * @alpha
13
13
  */
14
14
  export type CacheContentType = "snapshot" | "ops";
15
15
  /**
16
- * @internal
16
+ * @alpha
17
17
  */
18
18
  export interface IFileEntry {
19
19
  /**
@@ -31,7 +31,7 @@ export interface IFileEntry {
31
31
  }
32
32
  /**
33
33
  * Cache entry. Identifies file that this entry belongs to, and type of content stored in it.
34
- * @internal
34
+ * @alpha
35
35
  */
36
36
  export interface IEntry {
37
37
  /**
@@ -52,7 +52,7 @@ export interface IEntry {
52
52
  }
53
53
  /**
54
54
  * Cache entry. Identifies file that this entry belongs to, and type of content stored in it.
55
- * @internal
55
+ * @alpha
56
56
  */
57
57
  export interface ICacheEntry extends IEntry {
58
58
  /**
@@ -66,7 +66,7 @@ export interface ICacheEntry extends IEntry {
66
66
  * cache implementation that does not survive across sessions. Snapshot entires stored in the
67
67
  * IPersistedCache will be considered stale and removed after 2 days. Read the README for more
68
68
  * information.
69
- * @internal
69
+ * @alpha
70
70
  */
71
71
  export interface IPersistedCache {
72
72
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"odspCache.d.ts","sourceRoot":"","sources":["../src/odspCache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAElE;;;GAGG;AACH,eAAO,MAAM,WAAW,aAAa,CAAC;AACtC;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,KAAK,CAAC;AAOlD;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,WAAW,EAAE,YAAY,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,MAAM;IACtB;;;;OAIG;IACH,IAAI,EAAE,gBAAgB,CAAC;IAEvB;;;;;;;OAOG;IACH,GAAG,EAAE,MAAM,CAAC;CACZ;AAED;;;GAGG;AACH,MAAM,WAAW,WAAY,SAAQ,MAAM;IAC1C;;OAEG;IACH,IAAI,EAAE,UAAU,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC/B;;;;OAIG;IACH,GAAG,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAEtC;;;;;OAKG;IACH,GAAG,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnD;;;OAGG;IACH,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAE9D"}
1
+ {"version":3,"file":"odspCache.d.ts","sourceRoot":"","sources":["../src/odspCache.ts"],"names":[],"mappings":"AAAA;;;GAGG;OAEI,EAAE,YAAY,EAAE,MAAM,oCAAoC;AAEjE;;;GAGG;AACH,eAAO,MAAM,WAAW,aAAa,CAAC;AACtC;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,KAAK,CAAC;AAOlD;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,WAAW,EAAE,YAAY,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,MAAM;IACtB;;;;OAIG;IACH,IAAI,EAAE,gBAAgB,CAAC;IAEvB;;;;;;;OAOG;IACH,GAAG,EAAE,MAAM,CAAC;CACZ;AAED;;;GAGG;AACH,MAAM,WAAW,WAAY,SAAQ,MAAM;IAC1C;;OAEG;IACH,IAAI,EAAE,UAAU,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC/B;;;;OAIG;IACH,GAAG,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAEtC;;;;;OAKG;IACH,GAAG,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnD;;;OAGG;IACH,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAE9D"}
@@ -1 +1 @@
1
- {"version":3,"file":"odspCache.mjs","sourceRoot":"","sources":["../src/odspCache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,UAAU,CAAC;AA8FtC;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAkB;IACrD,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;AACzD,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport { IResolvedUrl } from \"@fluidframework/driver-definitions\";\n\n/**\n * Describes what kind of content is stored in cache entry.\n * @internal\n */\nexport const snapshotKey = \"snapshot\";\n/**\n * @internal\n */\nexport type CacheContentType = \"snapshot\" | \"ops\";\n\n/*\n * File / container identifier.\n * There is overlapping information here - host can use all of it or parts\n * to implement storage / identify files.\n */\n/**\n * @internal\n */\nexport interface IFileEntry {\n\t/**\n\t * Unique and stable ID of the document.\n\t * Driver guarantees that docId is stable ID uniquely identifying document.\n\t */\n\tdocId: string;\n\t/**\n\t * Resolved URI is provided for additional versatility - host can use it to\n\t * identify file in storage, and (as example) delete all cached entries for\n\t * a file if user requests so.\n\t * This is IOdspResolvedUrl in case of ODSP driver.\n\t */\n\tresolvedUrl: IResolvedUrl;\n}\n\n/**\n * Cache entry. Identifies file that this entry belongs to, and type of content stored in it.\n * @internal\n */\nexport interface IEntry {\n\t/**\n\t * Identifies type of entry for a given file.\n\t * Each file can have multiple types of entries associated with it.\n\t * For example, it can be snapshot, blob, ops, etc.\n\t */\n\ttype: CacheContentType;\n\n\t/**\n\t * Identifies individual entry for a given file and type.\n\t * Each file can have multiple cache entries associated with it.\n\t * This property identifies a particular instance of entry.\n\t * For example, for blobs it will be unique ID of the blob in a file.\n\t * For batch of ops, it can be starting op sequence number.\n\t * For types that have only one entry (like snapshots), it will be empty string.\n\t */\n\tkey: string;\n}\n\n/**\n * Cache entry. Identifies file that this entry belongs to, and type of content stored in it.\n * @internal\n */\nexport interface ICacheEntry extends IEntry {\n\t/**\n\t * Identifies file in storage this cached entry is for\n\t */\n\tfile: IFileEntry;\n}\n\n/**\n * Persistent cache. This interface can be implemented by the host to provide durable caching\n * across sessions. If not provided at driver factory construction, factory will use in-memory\n * cache implementation that does not survive across sessions. Snapshot entires stored in the\n * IPersistedCache will be considered stale and removed after 2 days. Read the README for more\n * information.\n * @internal\n */\nexport interface IPersistedCache {\n\t/**\n\t * Get the cache value of the key\n\t * @param entry - cache entry, identifies file and particular key for this file.\n\t * @returns Cached value. undefined if nothing is cached.\n\t */\n\tget(entry: ICacheEntry): Promise<any>;\n\n\t/**\n\t * Put the value into cache.\n\t * Important - only serializable content is allowed since this cache may be persisted between sessions\n\t * @param entry - cache entry.\n\t * @param value - JSON-serializable content.\n\t */\n\tput(entry: ICacheEntry, value: any): Promise<void>;\n\n\t/**\n\t * Removes the entries from the cache for given parametres.\n\t * @param file - file entry to be deleted.\n\t */\n\tremoveEntries(file: IFileEntry): Promise<void>;\n}\n\n/**\n * Api to generate a cache key from cache entry.\n * @param entry - cache entry from which a cache key is generated\n * @returns The key for cache.\n * @internal\n */\nexport function getKeyForCacheEntry(entry: ICacheEntry): string {\n\treturn `${entry.file.docId}_${entry.type}_${entry.key}`;\n}\n"]}
1
+ {"version":3,"file":"odspCache.mjs","sourceRoot":"","sources":["../src/odspCache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,UAAU,CAAC;AA8FtC;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAkB;IACrD,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;AACzD,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport { IResolvedUrl } from \"@fluidframework/driver-definitions\";\n\n/**\n * Describes what kind of content is stored in cache entry.\n * @internal\n */\nexport const snapshotKey = \"snapshot\";\n/**\n * @alpha\n */\nexport type CacheContentType = \"snapshot\" | \"ops\";\n\n/*\n * File / container identifier.\n * There is overlapping information here - host can use all of it or parts\n * to implement storage / identify files.\n */\n/**\n * @alpha\n */\nexport interface IFileEntry {\n\t/**\n\t * Unique and stable ID of the document.\n\t * Driver guarantees that docId is stable ID uniquely identifying document.\n\t */\n\tdocId: string;\n\t/**\n\t * Resolved URI is provided for additional versatility - host can use it to\n\t * identify file in storage, and (as example) delete all cached entries for\n\t * a file if user requests so.\n\t * This is IOdspResolvedUrl in case of ODSP driver.\n\t */\n\tresolvedUrl: IResolvedUrl;\n}\n\n/**\n * Cache entry. Identifies file that this entry belongs to, and type of content stored in it.\n * @alpha\n */\nexport interface IEntry {\n\t/**\n\t * Identifies type of entry for a given file.\n\t * Each file can have multiple types of entries associated with it.\n\t * For example, it can be snapshot, blob, ops, etc.\n\t */\n\ttype: CacheContentType;\n\n\t/**\n\t * Identifies individual entry for a given file and type.\n\t * Each file can have multiple cache entries associated with it.\n\t * This property identifies a particular instance of entry.\n\t * For example, for blobs it will be unique ID of the blob in a file.\n\t * For batch of ops, it can be starting op sequence number.\n\t * For types that have only one entry (like snapshots), it will be empty string.\n\t */\n\tkey: string;\n}\n\n/**\n * Cache entry. Identifies file that this entry belongs to, and type of content stored in it.\n * @alpha\n */\nexport interface ICacheEntry extends IEntry {\n\t/**\n\t * Identifies file in storage this cached entry is for\n\t */\n\tfile: IFileEntry;\n}\n\n/**\n * Persistent cache. This interface can be implemented by the host to provide durable caching\n * across sessions. If not provided at driver factory construction, factory will use in-memory\n * cache implementation that does not survive across sessions. Snapshot entires stored in the\n * IPersistedCache will be considered stale and removed after 2 days. Read the README for more\n * information.\n * @alpha\n */\nexport interface IPersistedCache {\n\t/**\n\t * Get the cache value of the key\n\t * @param entry - cache entry, identifies file and particular key for this file.\n\t * @returns Cached value. undefined if nothing is cached.\n\t */\n\tget(entry: ICacheEntry): Promise<any>;\n\n\t/**\n\t * Put the value into cache.\n\t * Important - only serializable content is allowed since this cache may be persisted between sessions\n\t * @param entry - cache entry.\n\t * @param value - JSON-serializable content.\n\t */\n\tput(entry: ICacheEntry, value: any): Promise<void>;\n\n\t/**\n\t * Removes the entries from the cache for given parametres.\n\t * @param file - file entry to be deleted.\n\t */\n\tremoveEntries(file: IFileEntry): Promise<void>;\n}\n\n/**\n * Api to generate a cache key from cache entry.\n * @param entry - cache entry from which a cache key is generated\n * @returns The key for cache.\n * @internal\n */\nexport function getKeyForCacheEntry(entry: ICacheEntry): string {\n\treturn `${entry.file.docId}_${entry.type}_${entry.key}`;\n}\n"]}
@@ -4,7 +4,7 @@
4
4
  */
5
5
  import { IResolvedUrl } from "@fluidframework/driver-definitions";
6
6
  /**
7
- * @internal
7
+ * @alpha
8
8
  */
9
9
  export interface IOdspUrlParts {
10
10
  siteUrl: string;
@@ -14,14 +14,14 @@ export interface IOdspUrlParts {
14
14
  /**
15
15
  * @deprecated Use ISharingLinkKind type instead.
16
16
  * Type of shareLink requested/created when creating the file for the first time.
17
- * @internal
17
+ * @alpha
18
18
  */
19
19
  export declare enum ShareLinkTypes {
20
20
  csl = "csl"
21
21
  }
22
22
  /**
23
23
  * Sharing scope of the share links created for a file.
24
- * @internal
24
+ * @alpha
25
25
  */
26
26
  export declare enum SharingLinkScope {
27
27
  organization = "organization",
@@ -31,7 +31,7 @@ export declare enum SharingLinkScope {
31
31
  }
32
32
  /**
33
33
  * View/edit permission role for a sharing link.
34
- * @internal
34
+ * @alpha
35
35
  */
36
36
  export declare enum SharingLinkRole {
37
37
  view = "view",
@@ -40,7 +40,7 @@ export declare enum SharingLinkRole {
40
40
  /**
41
41
  * Defines the permissions scope for a share link requested to be created during the creation the file in ODSP.
42
42
  * Providing these properties to the /snapshot api will also create and return the requested kind of sharing link.
43
- * @internal
43
+ * @alpha
44
44
  */
45
45
  export interface ISharingLinkKind {
46
46
  scope: SharingLinkScope;
@@ -48,7 +48,7 @@ export interface ISharingLinkKind {
48
48
  }
49
49
  /**
50
50
  * Sharing link data received from the /snapshot api response.
51
- * @internal
51
+ * @alpha
52
52
  */
53
53
  export interface ISharingLink extends ISharingLinkKind {
54
54
  webUrl: string;
@@ -57,7 +57,7 @@ export interface ISharingLink extends ISharingLinkKind {
57
57
  * Sharing link data created for the ODSP item.
58
58
  * Contains information about either sharing link created while creating a new file or
59
59
  * a redeemable share link created when loading an existing file
60
- * @internal
60
+ * @alpha
61
61
  */
62
62
  export interface ShareLinkInfoType {
63
63
  /**
@@ -92,7 +92,7 @@ export interface ShareLinkInfoType {
92
92
  sharingLinkToRedeem?: string;
93
93
  }
94
94
  /**
95
- * @internal
95
+ * @alpha
96
96
  */
97
97
  export interface IOdspResolvedUrl extends IResolvedUrl, IOdspUrlParts {
98
98
  type: "fluid";
@@ -1 +1 @@
1
- {"version":3,"file":"resolvedUrl.d.ts","sourceRoot":"","sources":["../src/resolvedUrl.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAElE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,oBAAY,cAAc;IACzB,GAAG,QAAQ;CACX;AAED;;;GAGG;AACH,oBAAY,gBAAgB;IAC3B,YAAY,iBAAiB;IAC7B,KAAK,UAAU;IACf,SAAS,cAAc;IACvB,OAAO,YAAY;CACnB;AAED;;;GAGG;AACH,oBAAY,eAAe;IAC1B,IAAI,SAAS;IACb,IAAI,SAAS;CACb;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAChC,KAAK,EAAE,gBAAgB,CAAC;IAKxB,IAAI,CAAC,EAAE,eAAe,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IACrD,MAAM,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IACjC;;;;;;OAMG;IACH,UAAU,CAAC,EAAE;QACZ;;;;;WAKG;QACH,IAAI,CAAC,EAAE,cAAc,GAAG,gBAAgB,CAAC;QAEzC;;WAEG;QACH,IAAI,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;QAE7B;;WAEG;QACH,KAAK,CAAC,EAAE,GAAG,CAAC;QAEZ,OAAO,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IAEF;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC7B;AACD;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,YAAY,EAAE,aAAa;IACpE,IAAI,EAAE,OAAO,CAAC;IACd,eAAe,EAAE,IAAI,CAAC;IAGtB,GAAG,EAAE,MAAM,CAAC;IAGZ,gBAAgB,EAAE,MAAM,CAAC;IAEzB,SAAS,EAAE;QACV,kBAAkB,EAAE,MAAM,CAAC;QAC3B,wBAAwB,EAAE,MAAM,CAAC;QACjC,uBAAuB,EAAE,MAAM,CAAC;QAChC,eAAe,EAAE,MAAM,CAAC;KACxB,CAAC;IAIF,MAAM,EAAE,EAAE,CAAC;IAEX,QAAQ,EAAE,MAAM,CAAC;IAEjB,UAAU,EAAE,OAAO,CAAC;IAEpB,QAAQ,CAAC,EAAE;QAGV,oBAAoB,CAAC,EAAE,MAAM,CAAC;KAC9B,CAAC;IAEF,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAEhC,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;;OAIG;IACH,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAElC,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC5B"}
1
+ {"version":3,"file":"resolvedUrl.d.ts","sourceRoot":"","sources":["../src/resolvedUrl.ts"],"names":[],"mappings":"AAAA;;;GAGG;OAEI,EAAE,YAAY,EAAE,MAAM,oCAAoC;AAEjE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,oBAAY,cAAc;IACzB,GAAG,QAAQ;CACX;AAED;;;GAGG;AACH,oBAAY,gBAAgB;IAC3B,YAAY,iBAAiB;IAC7B,KAAK,UAAU;IACf,SAAS,cAAc;IACvB,OAAO,YAAY;CACnB;AAED;;;GAGG;AACH,oBAAY,eAAe;IAC1B,IAAI,SAAS;IACb,IAAI,SAAS;CACb;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAChC,KAAK,EAAE,gBAAgB,CAAC;IAKxB,IAAI,CAAC,EAAE,eAAe,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IACrD,MAAM,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IACjC;;;;;;OAMG;IACH,UAAU,CAAC,EAAE;QACZ;;;;;WAKG;QACH,IAAI,CAAC,EAAE,cAAc,GAAG,gBAAgB,CAAC;QAEzC;;WAEG;QACH,IAAI,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;QAE7B;;WAEG;QACH,KAAK,CAAC,EAAE,GAAG,CAAC;QAEZ,OAAO,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IAEF;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC7B;AACD;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,YAAY,EAAE,aAAa;IACpE,IAAI,EAAE,OAAO,CAAC;IACd,eAAe,EAAE,IAAI,CAAC;IAGtB,GAAG,EAAE,MAAM,CAAC;IAGZ,gBAAgB,EAAE,MAAM,CAAC;IAEzB,SAAS,EAAE;QACV,kBAAkB,EAAE,MAAM,CAAC;QAC3B,wBAAwB,EAAE,MAAM,CAAC;QACjC,uBAAuB,EAAE,MAAM,CAAC;QAChC,eAAe,EAAE,MAAM,CAAC;KACxB,CAAC;IAIF,MAAM,EAAE,EAAE,CAAC;IAEX,QAAQ,EAAE,MAAM,CAAC;IAEjB,UAAU,EAAE,OAAO,CAAC;IAEpB,QAAQ,CAAC,EAAE;QAGV,oBAAoB,CAAC,EAAE,MAAM,CAAC;KAC9B,CAAC;IAEF,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAEhC,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;;OAIG;IACH,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAElC,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC5B"}
@@ -5,7 +5,7 @@
5
5
  /**
6
6
  * @deprecated Use ISharingLinkKind type instead.
7
7
  * Type of shareLink requested/created when creating the file for the first time.
8
- * @internal
8
+ * @alpha
9
9
  */
10
10
  export var ShareLinkTypes;
11
11
  (function (ShareLinkTypes) {
@@ -13,7 +13,7 @@ export var ShareLinkTypes;
13
13
  })(ShareLinkTypes || (ShareLinkTypes = {}));
14
14
  /**
15
15
  * Sharing scope of the share links created for a file.
16
- * @internal
16
+ * @alpha
17
17
  */
18
18
  export var SharingLinkScope;
19
19
  (function (SharingLinkScope) {
@@ -24,7 +24,7 @@ export var SharingLinkScope;
24
24
  })(SharingLinkScope || (SharingLinkScope = {}));
25
25
  /**
26
26
  * View/edit permission role for a sharing link.
27
- * @internal
27
+ * @alpha
28
28
  */
29
29
  export var SharingLinkRole;
30
30
  (function (SharingLinkRole) {
@@ -1 +1 @@
1
- {"version":3,"file":"resolvedUrl.mjs","sourceRoot":"","sources":["../src/resolvedUrl.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH;;;;GAIG;AACH,MAAM,CAAN,IAAY,cAEX;AAFD,WAAY,cAAc;IACzB,6BAAW,CAAA;AACZ,CAAC,EAFW,cAAc,KAAd,cAAc,QAEzB;AAED;;;GAGG;AACH,MAAM,CAAN,IAAY,gBAKX;AALD,WAAY,gBAAgB;IAC3B,iDAA6B,CAAA;IAC7B,mCAAe,CAAA;IACf,2CAAuB,CAAA;IACvB,uCAAmB,CAAA;AACpB,CAAC,EALW,gBAAgB,KAAhB,gBAAgB,QAK3B;AAED;;;GAGG;AACH,MAAM,CAAN,IAAY,eAGX;AAHD,WAAY,eAAe;IAC1B,gCAAa,CAAA;IACb,gCAAa,CAAA;AACd,CAAC,EAHW,eAAe,KAAf,eAAe,QAG1B","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport { IResolvedUrl } from \"@fluidframework/driver-definitions\";\n\n/**\n * @internal\n */\nexport interface IOdspUrlParts {\n\tsiteUrl: string;\n\tdriveId: string;\n\titemId: string;\n}\n\n/**\n * @deprecated Use ISharingLinkKind type instead.\n * Type of shareLink requested/created when creating the file for the first time.\n * @internal\n */\nexport enum ShareLinkTypes {\n\tcsl = \"csl\",\n}\n\n/**\n * Sharing scope of the share links created for a file.\n * @internal\n */\nexport enum SharingLinkScope {\n\torganization = \"organization\",\n\tusers = \"users\",\n\tanonymous = \"anonymous\",\n\tdefault = \"default\",\n}\n\n/**\n * View/edit permission role for a sharing link.\n * @internal\n */\nexport enum SharingLinkRole {\n\tview = \"view\",\n\tedit = \"edit\",\n}\n\n/**\n * Defines the permissions scope for a share link requested to be created during the creation the file in ODSP.\n * Providing these properties to the /snapshot api will also create and return the requested kind of sharing link.\n * @internal\n */\nexport interface ISharingLinkKind {\n\tscope: SharingLinkScope;\n\t/*\n\t * If this parameter is not provided, the API will default to \"edit\" links (provided\n\t * a valid createLinkScope setting is given).\n\t */\n\trole?: SharingLinkRole;\n}\n\n/**\n * Sharing link data received from the /snapshot api response.\n * @internal\n */\nexport interface ISharingLink extends ISharingLinkKind {\n\twebUrl: string;\n}\n\n/**\n * Sharing link data created for the ODSP item.\n * Contains information about either sharing link created while creating a new file or\n * a redeemable share link created when loading an existing file\n * @internal\n */\nexport interface ShareLinkInfoType {\n\t/**\n\t * We create a new file in ODSP with the /snapshot api call. Applications then need to make a separate apis call to\n\t * create a sharing link for that file. To reduce the number of network calls, ODSP now provides a feature\n\t * where we can create a share link along with creating a file by passing a query parameter called\n\t * createShareLink (deprecated) or createLinkScope and createLinkRole. createLink object below saves the information\n\t * from the /snapshot api response.\n\t */\n\tcreateLink?: {\n\t\t/**\n\t\t * @deprecated\n\t\t * Type of shareLink requested/created when creating the file for the first time. The 'type' property here\n\t\t * represents the type of sharing link requested.\n\t\t * Will be deprecated soon. Type of sharing link will be present in the link:ISharingLink property below.\n\t\t */\n\t\ttype?: ShareLinkTypes | ISharingLinkKind;\n\n\t\t/**\n\t\t * Share link created when the file is created for the first time with /snapshot api call.\n\t\t */\n\t\tlink?: string | ISharingLink;\n\n\t\t/**\n\t\t * Error message if creation of sharing link fails with /snapshot api call\n\t\t */\n\t\terror?: any;\n\n\t\tshareId?: string;\n\t};\n\n\t/**\n\t * This is used to save the network calls while doing trees/latest call as if the client does not have\n\t * permission then this link can be redeemed for the permissions in the same network call.\n\t */\n\tsharingLinkToRedeem?: string;\n}\n/**\n * @internal\n */\nexport interface IOdspResolvedUrl extends IResolvedUrl, IOdspUrlParts {\n\ttype: \"fluid\";\n\todspResolvedUrl: true;\n\n\t// URL to send to fluid, contains the documentId and the path\n\turl: string;\n\n\t// A hashed identifier that is unique to this document\n\thashedDocumentId: string;\n\n\tendpoints: {\n\t\tsnapshotStorageUrl: string;\n\t\tattachmentPOSTStorageUrl: string;\n\t\tattachmentGETStorageUrl: string;\n\t\tdeltaStorageUrl: string;\n\t};\n\n\t// Tokens are not obtained by the ODSP driver using the resolve flow, the app must provide them.\n\t// eslint-disable-next-line @typescript-eslint/ban-types\n\ttokens: {};\n\n\tfileName: string;\n\n\tsummarizer: boolean;\n\n\tcodeHint?: {\n\t\t// containerPackageName is used for adding the package name to the request headers.\n\t\t// This may be used for preloading the container package when loading Fluid content.\n\t\tcontainerPackageName?: string;\n\t};\n\n\tfileVersion: string | undefined;\n\n\tdataStorePath?: string;\n\n\t/**\n\t * Sharing link data created for the ODSP item.\n\t * Contains information about either sharing link created while creating a new file or\n\t * a redeemable share link created when loading an existing file\n\t */\n\tshareLinkInfo?: ShareLinkInfoType;\n\n\tisClpCompliantApp?: boolean;\n}\n"]}
1
+ {"version":3,"file":"resolvedUrl.mjs","sourceRoot":"","sources":["../src/resolvedUrl.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH;;;;GAIG;AACH,MAAM,CAAN,IAAY,cAEX;AAFD,WAAY,cAAc;IACzB,6BAAW,CAAA;AACZ,CAAC,EAFW,cAAc,KAAd,cAAc,QAEzB;AAED;;;GAGG;AACH,MAAM,CAAN,IAAY,gBAKX;AALD,WAAY,gBAAgB;IAC3B,iDAA6B,CAAA;IAC7B,mCAAe,CAAA;IACf,2CAAuB,CAAA;IACvB,uCAAmB,CAAA;AACpB,CAAC,EALW,gBAAgB,KAAhB,gBAAgB,QAK3B;AAED;;;GAGG;AACH,MAAM,CAAN,IAAY,eAGX;AAHD,WAAY,eAAe;IAC1B,gCAAa,CAAA;IACb,gCAAa,CAAA;AACd,CAAC,EAHW,eAAe,KAAf,eAAe,QAG1B","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport { IResolvedUrl } from \"@fluidframework/driver-definitions\";\n\n/**\n * @alpha\n */\nexport interface IOdspUrlParts {\n\tsiteUrl: string;\n\tdriveId: string;\n\titemId: string;\n}\n\n/**\n * @deprecated Use ISharingLinkKind type instead.\n * Type of shareLink requested/created when creating the file for the first time.\n * @alpha\n */\nexport enum ShareLinkTypes {\n\tcsl = \"csl\",\n}\n\n/**\n * Sharing scope of the share links created for a file.\n * @alpha\n */\nexport enum SharingLinkScope {\n\torganization = \"organization\",\n\tusers = \"users\",\n\tanonymous = \"anonymous\",\n\tdefault = \"default\",\n}\n\n/**\n * View/edit permission role for a sharing link.\n * @alpha\n */\nexport enum SharingLinkRole {\n\tview = \"view\",\n\tedit = \"edit\",\n}\n\n/**\n * Defines the permissions scope for a share link requested to be created during the creation the file in ODSP.\n * Providing these properties to the /snapshot api will also create and return the requested kind of sharing link.\n * @alpha\n */\nexport interface ISharingLinkKind {\n\tscope: SharingLinkScope;\n\t/*\n\t * If this parameter is not provided, the API will default to \"edit\" links (provided\n\t * a valid createLinkScope setting is given).\n\t */\n\trole?: SharingLinkRole;\n}\n\n/**\n * Sharing link data received from the /snapshot api response.\n * @alpha\n */\nexport interface ISharingLink extends ISharingLinkKind {\n\twebUrl: string;\n}\n\n/**\n * Sharing link data created for the ODSP item.\n * Contains information about either sharing link created while creating a new file or\n * a redeemable share link created when loading an existing file\n * @alpha\n */\nexport interface ShareLinkInfoType {\n\t/**\n\t * We create a new file in ODSP with the /snapshot api call. Applications then need to make a separate apis call to\n\t * create a sharing link for that file. To reduce the number of network calls, ODSP now provides a feature\n\t * where we can create a share link along with creating a file by passing a query parameter called\n\t * createShareLink (deprecated) or createLinkScope and createLinkRole. createLink object below saves the information\n\t * from the /snapshot api response.\n\t */\n\tcreateLink?: {\n\t\t/**\n\t\t * @deprecated\n\t\t * Type of shareLink requested/created when creating the file for the first time. The 'type' property here\n\t\t * represents the type of sharing link requested.\n\t\t * Will be deprecated soon. Type of sharing link will be present in the link:ISharingLink property below.\n\t\t */\n\t\ttype?: ShareLinkTypes | ISharingLinkKind;\n\n\t\t/**\n\t\t * Share link created when the file is created for the first time with /snapshot api call.\n\t\t */\n\t\tlink?: string | ISharingLink;\n\n\t\t/**\n\t\t * Error message if creation of sharing link fails with /snapshot api call\n\t\t */\n\t\terror?: any;\n\n\t\tshareId?: string;\n\t};\n\n\t/**\n\t * This is used to save the network calls while doing trees/latest call as if the client does not have\n\t * permission then this link can be redeemed for the permissions in the same network call.\n\t */\n\tsharingLinkToRedeem?: string;\n}\n/**\n * @alpha\n */\nexport interface IOdspResolvedUrl extends IResolvedUrl, IOdspUrlParts {\n\ttype: \"fluid\";\n\todspResolvedUrl: true;\n\n\t// URL to send to fluid, contains the documentId and the path\n\turl: string;\n\n\t// A hashed identifier that is unique to this document\n\thashedDocumentId: string;\n\n\tendpoints: {\n\t\tsnapshotStorageUrl: string;\n\t\tattachmentPOSTStorageUrl: string;\n\t\tattachmentGETStorageUrl: string;\n\t\tdeltaStorageUrl: string;\n\t};\n\n\t// Tokens are not obtained by the ODSP driver using the resolve flow, the app must provide them.\n\t// eslint-disable-next-line @typescript-eslint/ban-types\n\ttokens: {};\n\n\tfileName: string;\n\n\tsummarizer: boolean;\n\n\tcodeHint?: {\n\t\t// containerPackageName is used for adding the package name to the request headers.\n\t\t// This may be used for preloading the container package when loading Fluid content.\n\t\tcontainerPackageName?: string;\n\t};\n\n\tfileVersion: string | undefined;\n\n\tdataStorePath?: string;\n\n\t/**\n\t * Sharing link data created for the ODSP item.\n\t * Contains information about either sharing link created while creating a new file or\n\t * a redeemable share link created when loading an existing file\n\t */\n\tshareLinkInfo?: ShareLinkInfoType;\n\n\tisClpCompliantApp?: boolean;\n}\n"]}
@@ -5,7 +5,7 @@
5
5
  import { IResolvedUrl } from "@fluidframework/driver-definitions";
6
6
  /**
7
7
  * Socket storage discovery api response
8
- * @internal
8
+ * @alpha
9
9
  */
10
10
  export interface ISocketStorageDiscovery {
11
11
  id: string;
@@ -32,7 +32,7 @@ export interface ISocketStorageDiscovery {
32
32
  /**
33
33
  * An interface that allows a concrete instance of a driver factory to interrogate itself
34
34
  * to find out if it is session aware.
35
- * @internal
35
+ * @alpha
36
36
  */
37
37
  export interface IProvideSessionAwareDriverFactory {
38
38
  readonly IRelaySessionAwareDriverFactory: IRelaySessionAwareDriverFactory;
@@ -40,7 +40,7 @@ export interface IProvideSessionAwareDriverFactory {
40
40
  /**
41
41
  * An interface that allows a concrete instance of a driver factory to call the `getRelayServiceSessionInfo`
42
42
  * function if it session aware.
43
- * @internal
43
+ * @alpha
44
44
  */
45
45
  export interface IRelaySessionAwareDriverFactory extends IProvideSessionAwareDriverFactory {
46
46
  getRelayServiceSessionInfo(resolvedUrl: IResolvedUrl): Promise<ISocketStorageDiscovery | undefined>;
@@ -1 +1 @@
1
- {"version":3,"file":"sessionProvider.d.ts","sourceRoot":"","sources":["../src/sessionProvider.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAElE;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IAEvC,EAAE,EAAE,MAAM,CAAC;IAIX,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IAEjB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,oBAAoB,EAAE,MAAM,CAAC;IAE7B;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,6BAA6B,CAAC,EAAE,MAAM,CAAC;CACvC;AAED;;;;GAIG;AACH,MAAM,WAAW,iCAAiC;IACjD,QAAQ,CAAC,+BAA+B,EAAE,+BAA+B,CAAC;CAC1E;AAED;;;;GAIG;AACH,MAAM,WAAW,+BAAgC,SAAQ,iCAAiC;IACzF,0BAA0B,CACzB,WAAW,EAAE,YAAY,GACvB,OAAO,CAAC,uBAAuB,GAAG,SAAS,CAAC,CAAC;CAChD"}
1
+ {"version":3,"file":"sessionProvider.d.ts","sourceRoot":"","sources":["../src/sessionProvider.ts"],"names":[],"mappings":"AAAA;;;GAGG;OAEI,EAAE,YAAY,EAAE,MAAM,oCAAoC;AAEjE;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IAEvC,EAAE,EAAE,MAAM,CAAC;IAIX,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IAEjB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,oBAAoB,EAAE,MAAM,CAAC;IAE7B;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,6BAA6B,CAAC,EAAE,MAAM,CAAC;CACvC;AAED;;;;GAIG;AACH,MAAM,WAAW,iCAAiC;IACjD,QAAQ,CAAC,+BAA+B,EAAE,+BAA+B,CAAC;CAC1E;AAED;;;;GAIG;AACH,MAAM,WAAW,+BAAgC,SAAQ,iCAAiC;IACzF,0BAA0B,CACzB,WAAW,EAAE,YAAY,GACvB,OAAO,CAAC,uBAAuB,GAAG,SAAS,CAAC,CAAC;CAChD"}
@@ -1 +1 @@
1
- {"version":3,"file":"sessionProvider.mjs","sourceRoot":"","sources":["../src/sessionProvider.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport { IResolvedUrl } from \"@fluidframework/driver-definitions\";\n\n/**\n * Socket storage discovery api response\n * @internal\n */\nexport interface ISocketStorageDiscovery {\n\t// The id of the web socket\n\tid: string;\n\n\t// SPO gives us runtimeTenantId, we remap it to tenantId\n\t// See getSocketStorageDiscovery\n\truntimeTenantId?: string;\n\ttenantId: string;\n\n\tsnapshotStorageUrl: string;\n\tdeltaStorageUrl: string;\n\n\t/**\n\t * PUSH URL\n\t */\n\tdeltaStreamSocketUrl: string;\n\n\t/**\n\t * The access token for PushChannel. Optionally returned, depending on implementation.\n\t * OneDrive for Consumer implementation returns it and OneDrive for Business implementation\n\t * does not return it and instead expects token to be returned via `getWebsocketToken` callback\n\t * passed as a parameter to `OdspDocumentService.create()` factory.\n\t */\n\tsocketToken?: string;\n\n\t/**\n\t * This is the time within which client has to refresh the session on (ODSP) relay service.\n\t */\n\trefreshSessionDurationSeconds?: number;\n}\n\n/**\n * An interface that allows a concrete instance of a driver factory to interrogate itself\n * to find out if it is session aware.\n * @internal\n */\nexport interface IProvideSessionAwareDriverFactory {\n\treadonly IRelaySessionAwareDriverFactory: IRelaySessionAwareDriverFactory;\n}\n\n/**\n * An interface that allows a concrete instance of a driver factory to call the `getRelayServiceSessionInfo`\n * function if it session aware.\n * @internal\n */\nexport interface IRelaySessionAwareDriverFactory extends IProvideSessionAwareDriverFactory {\n\tgetRelayServiceSessionInfo(\n\t\tresolvedUrl: IResolvedUrl,\n\t): Promise<ISocketStorageDiscovery | undefined>;\n}\n"]}
1
+ {"version":3,"file":"sessionProvider.mjs","sourceRoot":"","sources":["../src/sessionProvider.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport { IResolvedUrl } from \"@fluidframework/driver-definitions\";\n\n/**\n * Socket storage discovery api response\n * @alpha\n */\nexport interface ISocketStorageDiscovery {\n\t// The id of the web socket\n\tid: string;\n\n\t// SPO gives us runtimeTenantId, we remap it to tenantId\n\t// See getSocketStorageDiscovery\n\truntimeTenantId?: string;\n\ttenantId: string;\n\n\tsnapshotStorageUrl: string;\n\tdeltaStorageUrl: string;\n\n\t/**\n\t * PUSH URL\n\t */\n\tdeltaStreamSocketUrl: string;\n\n\t/**\n\t * The access token for PushChannel. Optionally returned, depending on implementation.\n\t * OneDrive for Consumer implementation returns it and OneDrive for Business implementation\n\t * does not return it and instead expects token to be returned via `getWebsocketToken` callback\n\t * passed as a parameter to `OdspDocumentService.create()` factory.\n\t */\n\tsocketToken?: string;\n\n\t/**\n\t * This is the time within which client has to refresh the session on (ODSP) relay service.\n\t */\n\trefreshSessionDurationSeconds?: number;\n}\n\n/**\n * An interface that allows a concrete instance of a driver factory to interrogate itself\n * to find out if it is session aware.\n * @alpha\n */\nexport interface IProvideSessionAwareDriverFactory {\n\treadonly IRelaySessionAwareDriverFactory: IRelaySessionAwareDriverFactory;\n}\n\n/**\n * An interface that allows a concrete instance of a driver factory to call the `getRelayServiceSessionInfo`\n * function if it session aware.\n * @alpha\n */\nexport interface IRelaySessionAwareDriverFactory extends IProvideSessionAwareDriverFactory {\n\tgetRelayServiceSessionInfo(\n\t\tresolvedUrl: IResolvedUrl,\n\t): Promise<ISocketStorageDiscovery | undefined>;\n}\n"]}
@@ -4,7 +4,7 @@
4
4
  */
5
5
  /**
6
6
  * Represents token response
7
- * @internal
7
+ * @alpha
8
8
  */
9
9
  export interface TokenResponse {
10
10
  /** Token value */
@@ -14,7 +14,7 @@ export interface TokenResponse {
14
14
  }
15
15
  /**
16
16
  * Represents access token fetch options
17
- * @internal
17
+ * @alpha
18
18
  */
19
19
  export interface TokenFetchOptions {
20
20
  /**
@@ -36,7 +36,7 @@ export interface TokenFetchOptions {
36
36
  }
37
37
  /**
38
38
  * Represents access token fetch options for ODSP resource
39
- * @internal
39
+ * @alpha
40
40
  */
41
41
  export interface OdspResourceTokenFetchOptions extends TokenFetchOptions {
42
42
  /** Site url representing ODSP resource location */
@@ -52,7 +52,7 @@ export interface OdspResourceTokenFetchOptions extends TokenFetchOptions {
52
52
  * @returns If successful, TokenResponse object representing token value along with flag indicating
53
53
  * whether token came from cache. Legacy implementation may return a string for token value;
54
54
  * in this case it should be assumes that fromCache signal is undefined. Null is returned in case of failure.
55
- * @internal
55
+ * @alpha
56
56
  */
57
57
  export type TokenFetcher<T> = (options: T) => Promise<string | TokenResponse | null>;
58
58
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"tokenFetch.mjs","sourceRoot":"","sources":["../src/tokenFetch.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAChC,aAAwD,EACxC,EAAE,CAClB,aAAa,KAAK,IAAI,IAAI,OAAO,aAAa,KAAK,QAAQ;IAC1D,CAAC,CAAC,aAAa;IACf,CAAC,CAAC,aAAa,KAAK,SAAS;QAC7B,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC;AAExB;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC/B,aAA4C,EACtB,EAAE,CACxB,aAAa,KAAK,IAAI,IAAI,OAAO,aAAa,KAAK,QAAQ;IAC1D,CAAC,CAAC,SAAS;IACX,CAAC,CAAC,aAAa,CAAC,SAAS,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\n/**\n * Represents token response\n * @internal\n */\nexport interface TokenResponse {\n\t/** Token value */\n\ttoken: string;\n\n\t/** Flag indicating whether token was obtained from local cache */\n\tfromCache?: boolean;\n}\n\n/**\n * Represents access token fetch options\n * @internal\n */\nexport interface TokenFetchOptions {\n\t/**\n\t * Value indicating whether fresh token has to be returned.\n\t * If false then it is okay to return cached unexpired token if available.\n\t */\n\trefresh: boolean;\n\n\t/**\n\t * Claims that have to be passed with token fetch request.\n\t * These can be used to specify additional information that must be passed to token authority.\n\t */\n\tclaims?: string;\n\n\t/**\n\t * Tenant id of authority that must be handling token fetch.\n\t * If it is not specified then it is up to token fetching logic to determine which tenant authority\n\t * to use to issue access token.\n\t */\n\ttenantId?: string;\n}\n\n/**\n * Represents access token fetch options for ODSP resource\n * @internal\n */\nexport interface OdspResourceTokenFetchOptions extends TokenFetchOptions {\n\t/** Site url representing ODSP resource location */\n\tsiteUrl: string;\n\n\t/** ODSP drive id where resource resides. Optional, used only when fetching token to access ODSP file */\n\tdriveId?: string;\n\n\t/** ODSP item id representing resource. Optional, used only when fetching token to access ODSP file */\n\titemId?: string;\n}\n\n/**\n * Method signature for callback method used to fetch access token\n * @param options - token fetch options\n * @returns If successful, TokenResponse object representing token value along with flag indicating\n * whether token came from cache. Legacy implementation may return a string for token value;\n * in this case it should be assumes that fromCache signal is undefined. Null is returned in case of failure.\n * @internal\n */\nexport type TokenFetcher<T> = (options: T) => Promise<string | TokenResponse | null>;\n\n/**\n * Helper method which transforms return value for TokenFetcher method to token string\n * @param tokenResponse - return value for TokenFetcher method\n * @returns Token value\n * @internal\n */\nexport const tokenFromResponse = (\n\ttokenResponse: string | TokenResponse | null | undefined,\n): string | null =>\n\ttokenResponse === null || typeof tokenResponse === \"string\"\n\t\t? tokenResponse\n\t\t: tokenResponse === undefined\n\t\t? null\n\t\t: tokenResponse.token;\n\n/**\n * Helper method which returns flag indicating whether token response comes from local cache\n * @param tokenResponse - return value for TokenFetcher method\n * @returns Value indicating whether response came from cache.\n * Undefined is returned when we could not determine the source of token.\n * @internal\n */\nexport const isTokenFromCache = (\n\ttokenResponse: string | TokenResponse | null,\n): boolean | undefined =>\n\ttokenResponse === null || typeof tokenResponse === \"string\"\n\t\t? undefined\n\t\t: tokenResponse.fromCache;\n\n/**\n * Identity types supported by ODSP driver.\n * `Consumer` represents user authenticated with Microsoft Account (MSA).\n * `Enterprise` represents user authenticated with M365 tenant account.\n * @internal\n */\nexport type IdentityType = \"Consumer\" | \"Enterprise\";\n\n/**\n * @internal\n */\nexport type InstrumentedStorageTokenFetcher = (\n\toptions: TokenFetchOptions,\n\tname: string,\n\talwaysRecordTokenFetchTelemetry?: boolean,\n) => Promise<string | null>;\n"]}
1
+ {"version":3,"file":"tokenFetch.mjs","sourceRoot":"","sources":["../src/tokenFetch.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAChC,aAAwD,EACxC,EAAE,CAClB,aAAa,KAAK,IAAI,IAAI,OAAO,aAAa,KAAK,QAAQ;IAC1D,CAAC,CAAC,aAAa;IACf,CAAC,CAAC,aAAa,KAAK,SAAS;QAC7B,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC;AAExB;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC/B,aAA4C,EACtB,EAAE,CACxB,aAAa,KAAK,IAAI,IAAI,OAAO,aAAa,KAAK,QAAQ;IAC1D,CAAC,CAAC,SAAS;IACX,CAAC,CAAC,aAAa,CAAC,SAAS,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\n/**\n * Represents token response\n * @alpha\n */\nexport interface TokenResponse {\n\t/** Token value */\n\ttoken: string;\n\n\t/** Flag indicating whether token was obtained from local cache */\n\tfromCache?: boolean;\n}\n\n/**\n * Represents access token fetch options\n * @alpha\n */\nexport interface TokenFetchOptions {\n\t/**\n\t * Value indicating whether fresh token has to be returned.\n\t * If false then it is okay to return cached unexpired token if available.\n\t */\n\trefresh: boolean;\n\n\t/**\n\t * Claims that have to be passed with token fetch request.\n\t * These can be used to specify additional information that must be passed to token authority.\n\t */\n\tclaims?: string;\n\n\t/**\n\t * Tenant id of authority that must be handling token fetch.\n\t * If it is not specified then it is up to token fetching logic to determine which tenant authority\n\t * to use to issue access token.\n\t */\n\ttenantId?: string;\n}\n\n/**\n * Represents access token fetch options for ODSP resource\n * @alpha\n */\nexport interface OdspResourceTokenFetchOptions extends TokenFetchOptions {\n\t/** Site url representing ODSP resource location */\n\tsiteUrl: string;\n\n\t/** ODSP drive id where resource resides. Optional, used only when fetching token to access ODSP file */\n\tdriveId?: string;\n\n\t/** ODSP item id representing resource. Optional, used only when fetching token to access ODSP file */\n\titemId?: string;\n}\n\n/**\n * Method signature for callback method used to fetch access token\n * @param options - token fetch options\n * @returns If successful, TokenResponse object representing token value along with flag indicating\n * whether token came from cache. Legacy implementation may return a string for token value;\n * in this case it should be assumes that fromCache signal is undefined. Null is returned in case of failure.\n * @alpha\n */\nexport type TokenFetcher<T> = (options: T) => Promise<string | TokenResponse | null>;\n\n/**\n * Helper method which transforms return value for TokenFetcher method to token string\n * @param tokenResponse - return value for TokenFetcher method\n * @returns Token value\n * @internal\n */\nexport const tokenFromResponse = (\n\ttokenResponse: string | TokenResponse | null | undefined,\n): string | null =>\n\ttokenResponse === null || typeof tokenResponse === \"string\"\n\t\t? tokenResponse\n\t\t: tokenResponse === undefined\n\t\t? null\n\t\t: tokenResponse.token;\n\n/**\n * Helper method which returns flag indicating whether token response comes from local cache\n * @param tokenResponse - return value for TokenFetcher method\n * @returns Value indicating whether response came from cache.\n * Undefined is returned when we could not determine the source of token.\n * @internal\n */\nexport const isTokenFromCache = (\n\ttokenResponse: string | TokenResponse | null,\n): boolean | undefined =>\n\ttokenResponse === null || typeof tokenResponse === \"string\"\n\t\t? undefined\n\t\t: tokenResponse.fromCache;\n\n/**\n * Identity types supported by ODSP driver.\n * `Consumer` represents user authenticated with Microsoft Account (MSA).\n * `Enterprise` represents user authenticated with M365 tenant account.\n * @internal\n */\nexport type IdentityType = \"Consumer\" | \"Enterprise\";\n\n/**\n * @internal\n */\nexport type InstrumentedStorageTokenFetcher = (\n\toptions: TokenFetchOptions,\n\tname: string,\n\talwaysRecordTokenFetchTelemetry?: boolean,\n) => Promise<string | null>;\n"]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@fluidframework/odsp-driver-definitions",
3
- "version": "2.0.0-dev.7.4.0.217884",
3
+ "version": "2.0.0-dev.7.4.0.221926",
4
4
  "description": "Socket storage implementation for SPO and ODC",
5
5
  "homepage": "https://fluidframework.com",
6
6
  "repository": {
@@ -15,9 +15,10 @@
15
15
  "module": "lib/index.mjs",
16
16
  "types": "dist/index.d.ts",
17
17
  "dependencies": {
18
- "@fluidframework/driver-definitions": "2.0.0-dev.7.4.0.217884"
18
+ "@fluidframework/driver-definitions": "2.0.0-dev.7.4.0.221926"
19
19
  },
20
20
  "devDependencies": {
21
+ "@arethetypeswrong/cli": "^0.13.3",
21
22
  "@fluid-tools/build-cli": "^0.28.0",
22
23
  "@fluidframework/build-common": "^2.0.3",
23
24
  "@fluidframework/build-tools": "^0.28.0",
@@ -58,6 +59,7 @@
58
59
  "build:docs": "fluid-build . --task api",
59
60
  "build:esnext": "tsc-multi --config ../../../common/build/build-common/tsc-multi.esm.json",
60
61
  "build:test": "tsc-multi --config ./tsc-multi.test.json",
62
+ "check:are-the-types-wrong": "attw --pack",
61
63
  "check:release-tags": "api-extractor run --local --config ./api-extractor-lint.json",
62
64
  "ci:build:docs": "api-extractor run",
63
65
  "clean": "rimraf --glob dist lib \"**/*.tsbuildinfo\" \"**/*.build.log\" _api-extractor-temp",
package/src/factory.ts CHANGED
@@ -4,7 +4,7 @@
4
4
  */
5
5
 
6
6
  /**
7
- * @internal
7
+ * @alpha
8
8
  */
9
9
  export interface ISnapshotOptions {
10
10
  blobs?: number;
@@ -26,7 +26,7 @@ export interface ISnapshotOptions {
26
26
  }
27
27
 
28
28
  /**
29
- * @internal
29
+ * @alpha
30
30
  */
31
31
  export interface IOpsCachingPolicy {
32
32
  /**
@@ -57,7 +57,7 @@ export interface IOpsCachingPolicy {
57
57
  }
58
58
 
59
59
  /**
60
- * @internal
60
+ * @alpha
61
61
  */
62
62
  export interface ICollabSessionOptions {
63
63
  /**
@@ -79,7 +79,7 @@ export interface ICollabSessionOptions {
79
79
  }
80
80
 
81
81
  /**
82
- * @internal
82
+ * @alpha
83
83
  */
84
84
  export interface HostStoragePolicy {
85
85
  snapshotOptions?: ISnapshotOptions;
package/src/odspCache.ts CHANGED
@@ -11,7 +11,7 @@ import { IResolvedUrl } from "@fluidframework/driver-definitions";
11
11
  */
12
12
  export const snapshotKey = "snapshot";
13
13
  /**
14
- * @internal
14
+ * @alpha
15
15
  */
16
16
  export type CacheContentType = "snapshot" | "ops";
17
17
 
@@ -21,7 +21,7 @@ export type CacheContentType = "snapshot" | "ops";
21
21
  * to implement storage / identify files.
22
22
  */
23
23
  /**
24
- * @internal
24
+ * @alpha
25
25
  */
26
26
  export interface IFileEntry {
27
27
  /**
@@ -40,7 +40,7 @@ export interface IFileEntry {
40
40
 
41
41
  /**
42
42
  * Cache entry. Identifies file that this entry belongs to, and type of content stored in it.
43
- * @internal
43
+ * @alpha
44
44
  */
45
45
  export interface IEntry {
46
46
  /**
@@ -63,7 +63,7 @@ export interface IEntry {
63
63
 
64
64
  /**
65
65
  * Cache entry. Identifies file that this entry belongs to, and type of content stored in it.
66
- * @internal
66
+ * @alpha
67
67
  */
68
68
  export interface ICacheEntry extends IEntry {
69
69
  /**
@@ -78,7 +78,7 @@ export interface ICacheEntry extends IEntry {
78
78
  * cache implementation that does not survive across sessions. Snapshot entires stored in the
79
79
  * IPersistedCache will be considered stale and removed after 2 days. Read the README for more
80
80
  * information.
81
- * @internal
81
+ * @alpha
82
82
  */
83
83
  export interface IPersistedCache {
84
84
  /**