@fluidframework/local-driver 2.0.0-internal.7.0.0 → 2.0.0-internal.7.1.0
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.
- package/CHANGELOG.md +4 -0
- package/api-extractor.json +9 -1
- package/api-report/local-driver.api.md +129 -0
- package/dist/auth.d.ts.map +1 -1
- package/dist/auth.js +5 -3
- package/dist/auth.js.map +1 -1
- package/dist/local-driver-alpha.d.ts +211 -0
- package/dist/local-driver-beta.d.ts +211 -0
- package/dist/local-driver-public.d.ts +211 -0
- package/dist/local-driver.d.ts +211 -0
- package/dist/localDocumentStorageService.d.ts.map +1 -1
- package/dist/localDocumentStorageService.js +1 -0
- package/dist/localDocumentStorageService.js.map +1 -1
- package/dist/tsdoc-metadata.json +1 -1
- package/lib/auth.d.ts.map +1 -1
- package/lib/auth.js +5 -3
- package/lib/auth.js.map +1 -1
- package/lib/localDocumentStorageService.d.ts.map +1 -1
- package/lib/localDocumentStorageService.js +1 -0
- package/lib/localDocumentStorageService.js.map +1 -1
- package/package.json +20 -19
- package/src/auth.ts +6 -3
- package/src/localDocumentStorageService.ts +1 -0
|
@@ -0,0 +1,211 @@
|
|
|
1
|
+
import { DocumentDeltaConnection } from '@fluidframework/driver-base';
|
|
2
|
+
import { GitManager } from '@fluidframework/server-services-client';
|
|
3
|
+
import { IClient } from '@fluidframework/protocol-definitions';
|
|
4
|
+
import { ICreateBlobResponse } from '@fluidframework/protocol-definitions';
|
|
5
|
+
import { IDatabaseManager } from '@fluidframework/server-services-core';
|
|
6
|
+
import { IDb } from '@fluidframework/server-services-core';
|
|
7
|
+
import { IDocumentDeltaConnection } from '@fluidframework/driver-definitions';
|
|
8
|
+
import { IDocumentDeltaStorageService } from '@fluidframework/driver-definitions';
|
|
9
|
+
import { IDocumentMessage } from '@fluidframework/protocol-definitions';
|
|
10
|
+
import { IDocumentService } from '@fluidframework/driver-definitions';
|
|
11
|
+
import { IDocumentServiceFactory } from '@fluidframework/driver-definitions';
|
|
12
|
+
import { IDocumentServicePolicies } from '@fluidframework/driver-definitions';
|
|
13
|
+
import { IDocumentStorageService } from '@fluidframework/driver-definitions';
|
|
14
|
+
import { IDocumentStorageServicePolicies } from '@fluidframework/driver-definitions';
|
|
15
|
+
import { ILocalDeltaConnectionServer } from '@fluidframework/server-local-server';
|
|
16
|
+
import { IRequest } from '@fluidframework/core-interfaces';
|
|
17
|
+
import { IResolvedUrl } from '@fluidframework/driver-definitions';
|
|
18
|
+
import { ISequencedDocumentMessage } from '@fluidframework/protocol-definitions';
|
|
19
|
+
import { ISnapshotTreeEx } from '@fluidframework/protocol-definitions';
|
|
20
|
+
import { IStream } from '@fluidframework/driver-definitions';
|
|
21
|
+
import { ISummaryContext } from '@fluidframework/driver-definitions';
|
|
22
|
+
import { ISummaryHandle } from '@fluidframework/protocol-definitions';
|
|
23
|
+
import { ISummaryTree } from '@fluidframework/protocol-definitions';
|
|
24
|
+
import { ITelemetryBaseLogger } from '@fluidframework/core-interfaces';
|
|
25
|
+
import { ITestDbFactory } from '@fluidframework/server-test-utils';
|
|
26
|
+
import { ITokenProvider } from '@fluidframework/routerlicious-driver';
|
|
27
|
+
import { IUrlResolver } from '@fluidframework/driver-definitions';
|
|
28
|
+
import { IVersion } from '@fluidframework/protocol-definitions';
|
|
29
|
+
import { IWebSocketServer } from '@fluidframework/server-services-core';
|
|
30
|
+
import { NackErrorType } from '@fluidframework/protocol-definitions';
|
|
31
|
+
import type { Socket } from 'socket.io-client';
|
|
32
|
+
|
|
33
|
+
/**
|
|
34
|
+
* Creates and returns a document service for local use.
|
|
35
|
+
* @param localDeltaConnectionServer - delta connection server for ops
|
|
36
|
+
* @param tokenProvider - token provider with a single token
|
|
37
|
+
* @param tenantId - ID of tenant
|
|
38
|
+
* @param documentId - ID of document
|
|
39
|
+
*/
|
|
40
|
+
export declare function createLocalDocumentService(resolvedUrl: IResolvedUrl, localDeltaConnectionServer: ILocalDeltaConnectionServer, tokenProvider: ITokenProvider, tenantId: string, documentId: string, documentDeltaConnectionsMap: Map<string, LocalDocumentDeltaConnection>, policies?: IDocumentServicePolicies, innerDocumentService?: IDocumentService, logger?: ITelemetryBaseLogger): IDocumentService;
|
|
41
|
+
|
|
42
|
+
export declare function createLocalResolverCreateNewRequest(documentId: string): IRequest;
|
|
43
|
+
|
|
44
|
+
/**
|
|
45
|
+
* Provides access to the underlying delta storage on the server for local driver.
|
|
46
|
+
*/
|
|
47
|
+
export declare class LocalDeltaStorageService implements IDocumentDeltaStorageService {
|
|
48
|
+
private readonly tenantId;
|
|
49
|
+
private readonly id;
|
|
50
|
+
private readonly databaseManager;
|
|
51
|
+
constructor(tenantId: string, id: string, databaseManager: IDatabaseManager);
|
|
52
|
+
fetchMessages(from: number, to: number | undefined, abortSignal?: AbortSignal, cachedOnly?: boolean): IStream<ISequencedDocumentMessage[]>;
|
|
53
|
+
private getCore;
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
/**
|
|
57
|
+
* Represents a connection to a stream of delta updates
|
|
58
|
+
*/
|
|
59
|
+
export declare class LocalDocumentDeltaConnection extends DocumentDeltaConnection {
|
|
60
|
+
/**
|
|
61
|
+
* Create a LocalDocumentDeltaConnection
|
|
62
|
+
* Handle initial messages, contents or signals if they were in queue
|
|
63
|
+
*
|
|
64
|
+
* @param tenantId - the ID of the tenant
|
|
65
|
+
* @param id - document ID
|
|
66
|
+
* @param token - authorization token for storage service
|
|
67
|
+
* @param client - information about the client
|
|
68
|
+
* @param webSocketServer - web socket server to create connection
|
|
69
|
+
*/
|
|
70
|
+
static create(tenantId: string, id: string, token: string, client: IClient, webSocketServer: IWebSocketServer, timeoutMs?: number, logger?: ITelemetryBaseLogger): Promise<LocalDocumentDeltaConnection>;
|
|
71
|
+
constructor(socket: Socket, documentId: string, logger?: ITelemetryBaseLogger);
|
|
72
|
+
/**
|
|
73
|
+
* Submits a new delta operation to the server
|
|
74
|
+
*/
|
|
75
|
+
submit(messages: IDocumentMessage[]): void;
|
|
76
|
+
/**
|
|
77
|
+
* Submits a new signal to the server
|
|
78
|
+
*/
|
|
79
|
+
submitSignal(message: any): void;
|
|
80
|
+
/**
|
|
81
|
+
* Send a "disconnect" message on the socket.
|
|
82
|
+
* @param disconnectReason - The reason of the disconnection.
|
|
83
|
+
*/
|
|
84
|
+
disconnectClient(disconnectReason: string): void;
|
|
85
|
+
/**
|
|
86
|
+
* * Sends a "nack" message on the socket.
|
|
87
|
+
* @param code - An error code number that represents the error. It will be a valid HTTP error code.
|
|
88
|
+
* @param type - Type of the Nack.
|
|
89
|
+
* @param message - A message about the nack for debugging/logging/telemetry purposes.
|
|
90
|
+
*/
|
|
91
|
+
nackClient(code: number | undefined, type: NackErrorType | undefined, message: any): void;
|
|
92
|
+
}
|
|
93
|
+
|
|
94
|
+
/**
|
|
95
|
+
* Basic implementation of a document service for local use.
|
|
96
|
+
*/
|
|
97
|
+
export declare class LocalDocumentService implements IDocumentService {
|
|
98
|
+
readonly resolvedUrl: IResolvedUrl;
|
|
99
|
+
private readonly localDeltaConnectionServer;
|
|
100
|
+
private readonly tokenProvider;
|
|
101
|
+
private readonly tenantId;
|
|
102
|
+
private readonly documentId;
|
|
103
|
+
private readonly documentDeltaConnectionsMap;
|
|
104
|
+
readonly policies: IDocumentServicePolicies;
|
|
105
|
+
private readonly innerDocumentService?;
|
|
106
|
+
private readonly logger?;
|
|
107
|
+
/**
|
|
108
|
+
* @param localDeltaConnectionServer - delta connection server for ops
|
|
109
|
+
* @param tokenProvider - token provider
|
|
110
|
+
* @param tenantId - ID of tenant
|
|
111
|
+
* @param documentId - ID of document
|
|
112
|
+
*/
|
|
113
|
+
constructor(resolvedUrl: IResolvedUrl, localDeltaConnectionServer: ILocalDeltaConnectionServer, tokenProvider: ITokenProvider, tenantId: string, documentId: string, documentDeltaConnectionsMap: Map<string, LocalDocumentDeltaConnection>, policies?: IDocumentServicePolicies, innerDocumentService?: IDocumentService | undefined, logger?: ITelemetryBaseLogger | undefined);
|
|
114
|
+
dispose(): void;
|
|
115
|
+
/**
|
|
116
|
+
* Creates and returns a document storage service for local use.
|
|
117
|
+
*/
|
|
118
|
+
connectToStorage(): Promise<IDocumentStorageService>;
|
|
119
|
+
/**
|
|
120
|
+
* Creates and returns a delta storage service for local use.
|
|
121
|
+
*/
|
|
122
|
+
connectToDeltaStorage(): Promise<IDocumentDeltaStorageService>;
|
|
123
|
+
/**
|
|
124
|
+
* Creates and returns a delta stream for local use.
|
|
125
|
+
* @param client - client data
|
|
126
|
+
*/
|
|
127
|
+
connectToDeltaStream(client: IClient): Promise<IDocumentDeltaConnection>;
|
|
128
|
+
}
|
|
129
|
+
|
|
130
|
+
/**
|
|
131
|
+
* Implementation of document service factory for local use.
|
|
132
|
+
*/
|
|
133
|
+
export declare class LocalDocumentServiceFactory implements IDocumentServiceFactory {
|
|
134
|
+
private readonly localDeltaConnectionServer;
|
|
135
|
+
private readonly policies?;
|
|
136
|
+
private readonly innerDocumentService?;
|
|
137
|
+
private readonly documentDeltaConnectionsMap;
|
|
138
|
+
/**
|
|
139
|
+
* @param localDeltaConnectionServer - delta connection server for ops
|
|
140
|
+
*/
|
|
141
|
+
constructor(localDeltaConnectionServer: ILocalDeltaConnectionServer, policies?: IDocumentServicePolicies | undefined, innerDocumentService?: IDocumentService | undefined);
|
|
142
|
+
createContainer(createNewSummary: ISummaryTree | undefined, resolvedUrl: IResolvedUrl, logger?: ITelemetryBaseLogger, clientIsSummarizer?: boolean): Promise<IDocumentService>;
|
|
143
|
+
/**
|
|
144
|
+
* Creates and returns a document service for testing using the given resolved
|
|
145
|
+
* URL for the tenant ID, document ID, and token.
|
|
146
|
+
* @param resolvedUrl - resolved URL of document
|
|
147
|
+
*/
|
|
148
|
+
createDocumentService(resolvedUrl: IResolvedUrl, logger?: ITelemetryBaseLogger, clientIsSummarizer?: boolean): Promise<IDocumentService>;
|
|
149
|
+
/**
|
|
150
|
+
* Gets the document delta connection for the clientId and asks it to disconnect the client.
|
|
151
|
+
* @param clientId - The ID of the client to be disconnected.
|
|
152
|
+
* @param disconnectReason - The reason of the disconnection.
|
|
153
|
+
*/
|
|
154
|
+
disconnectClient(clientId: string, disconnectReason: string): void;
|
|
155
|
+
/**
|
|
156
|
+
* Gets the document delta connection for the clientId and asks it to nack the client.
|
|
157
|
+
* @param clientId - The ID of the client to be Nack'd.
|
|
158
|
+
* @param code - An error code number that represents the error. It will be a valid HTTP error code.
|
|
159
|
+
* @param type - Type of the Nack.
|
|
160
|
+
* @param message - A message about the nack for debugging/logging/telemetry purposes.
|
|
161
|
+
*/
|
|
162
|
+
nackClient(clientId: string, code?: number, type?: NackErrorType, message?: any): void;
|
|
163
|
+
}
|
|
164
|
+
|
|
165
|
+
export declare class LocalDocumentStorageService implements IDocumentStorageService {
|
|
166
|
+
private readonly id;
|
|
167
|
+
private readonly manager;
|
|
168
|
+
readonly policies: IDocumentStorageServicePolicies;
|
|
169
|
+
private readonly localDeltaConnectionServer?;
|
|
170
|
+
private readonly resolvedUrl?;
|
|
171
|
+
protected readonly blobsShaCache: Map<string, string>;
|
|
172
|
+
private readonly summaryTreeUploadManager;
|
|
173
|
+
get repositoryUrl(): string;
|
|
174
|
+
constructor(id: string, manager: GitManager, policies: IDocumentStorageServicePolicies, localDeltaConnectionServer?: ILocalDeltaConnectionServer | undefined, resolvedUrl?: IResolvedUrl | undefined);
|
|
175
|
+
getVersions(versionId: string | null, count: number): Promise<IVersion[]>;
|
|
176
|
+
getSnapshotTree(version?: IVersion): Promise<ISnapshotTreeEx | null>;
|
|
177
|
+
readBlob(blobId: string): Promise<ArrayBufferLike>;
|
|
178
|
+
uploadSummaryWithContext(summary: ISummaryTree, context: ISummaryContext): Promise<string>;
|
|
179
|
+
createBlob(file: ArrayBufferLike): Promise<ICreateBlobResponse>;
|
|
180
|
+
downloadSummary(handle: ISummaryHandle): Promise<ISummaryTree>;
|
|
181
|
+
private getPreviousFullSnapshot;
|
|
182
|
+
}
|
|
183
|
+
|
|
184
|
+
/**
|
|
185
|
+
* Resolves URLs by providing fake URLs which succeed with the other
|
|
186
|
+
* related local classes.
|
|
187
|
+
*/
|
|
188
|
+
export declare class LocalResolver implements IUrlResolver {
|
|
189
|
+
private readonly tenantId;
|
|
190
|
+
private readonly tokenKey;
|
|
191
|
+
constructor();
|
|
192
|
+
/**
|
|
193
|
+
* Resolves URL requests by providing fake URLs with an actually generated
|
|
194
|
+
* token from constant test strings. The root of the URL is fake, but the
|
|
195
|
+
* remaining relative URL can still be parsed.
|
|
196
|
+
* @param request - request to handle
|
|
197
|
+
*/
|
|
198
|
+
resolve(request: IRequest): Promise<IResolvedUrl>;
|
|
199
|
+
getAbsoluteUrl(resolvedUrl: IResolvedUrl, relativeUrl: string): Promise<string>;
|
|
200
|
+
createCreateNewRequest(documentId: string): IRequest;
|
|
201
|
+
}
|
|
202
|
+
|
|
203
|
+
/**
|
|
204
|
+
* A database factory for testing that stores data in the browsers session storage
|
|
205
|
+
*/
|
|
206
|
+
export declare class LocalSessionStorageDbFactory implements ITestDbFactory {
|
|
207
|
+
readonly testDatabase: IDb;
|
|
208
|
+
connect(): Promise<IDb>;
|
|
209
|
+
}
|
|
210
|
+
|
|
211
|
+
export { }
|
|
@@ -0,0 +1,211 @@
|
|
|
1
|
+
import { DocumentDeltaConnection } from '@fluidframework/driver-base';
|
|
2
|
+
import { GitManager } from '@fluidframework/server-services-client';
|
|
3
|
+
import { IClient } from '@fluidframework/protocol-definitions';
|
|
4
|
+
import { ICreateBlobResponse } from '@fluidframework/protocol-definitions';
|
|
5
|
+
import { IDatabaseManager } from '@fluidframework/server-services-core';
|
|
6
|
+
import { IDb } from '@fluidframework/server-services-core';
|
|
7
|
+
import { IDocumentDeltaConnection } from '@fluidframework/driver-definitions';
|
|
8
|
+
import { IDocumentDeltaStorageService } from '@fluidframework/driver-definitions';
|
|
9
|
+
import { IDocumentMessage } from '@fluidframework/protocol-definitions';
|
|
10
|
+
import { IDocumentService } from '@fluidframework/driver-definitions';
|
|
11
|
+
import { IDocumentServiceFactory } from '@fluidframework/driver-definitions';
|
|
12
|
+
import { IDocumentServicePolicies } from '@fluidframework/driver-definitions';
|
|
13
|
+
import { IDocumentStorageService } from '@fluidframework/driver-definitions';
|
|
14
|
+
import { IDocumentStorageServicePolicies } from '@fluidframework/driver-definitions';
|
|
15
|
+
import { ILocalDeltaConnectionServer } from '@fluidframework/server-local-server';
|
|
16
|
+
import { IRequest } from '@fluidframework/core-interfaces';
|
|
17
|
+
import { IResolvedUrl } from '@fluidframework/driver-definitions';
|
|
18
|
+
import { ISequencedDocumentMessage } from '@fluidframework/protocol-definitions';
|
|
19
|
+
import { ISnapshotTreeEx } from '@fluidframework/protocol-definitions';
|
|
20
|
+
import { IStream } from '@fluidframework/driver-definitions';
|
|
21
|
+
import { ISummaryContext } from '@fluidframework/driver-definitions';
|
|
22
|
+
import { ISummaryHandle } from '@fluidframework/protocol-definitions';
|
|
23
|
+
import { ISummaryTree } from '@fluidframework/protocol-definitions';
|
|
24
|
+
import { ITelemetryBaseLogger } from '@fluidframework/core-interfaces';
|
|
25
|
+
import { ITestDbFactory } from '@fluidframework/server-test-utils';
|
|
26
|
+
import { ITokenProvider } from '@fluidframework/routerlicious-driver';
|
|
27
|
+
import { IUrlResolver } from '@fluidframework/driver-definitions';
|
|
28
|
+
import { IVersion } from '@fluidframework/protocol-definitions';
|
|
29
|
+
import { IWebSocketServer } from '@fluidframework/server-services-core';
|
|
30
|
+
import { NackErrorType } from '@fluidframework/protocol-definitions';
|
|
31
|
+
import type { Socket } from 'socket.io-client';
|
|
32
|
+
|
|
33
|
+
/**
|
|
34
|
+
* Creates and returns a document service for local use.
|
|
35
|
+
* @param localDeltaConnectionServer - delta connection server for ops
|
|
36
|
+
* @param tokenProvider - token provider with a single token
|
|
37
|
+
* @param tenantId - ID of tenant
|
|
38
|
+
* @param documentId - ID of document
|
|
39
|
+
*/
|
|
40
|
+
export declare function createLocalDocumentService(resolvedUrl: IResolvedUrl, localDeltaConnectionServer: ILocalDeltaConnectionServer, tokenProvider: ITokenProvider, tenantId: string, documentId: string, documentDeltaConnectionsMap: Map<string, LocalDocumentDeltaConnection>, policies?: IDocumentServicePolicies, innerDocumentService?: IDocumentService, logger?: ITelemetryBaseLogger): IDocumentService;
|
|
41
|
+
|
|
42
|
+
export declare function createLocalResolverCreateNewRequest(documentId: string): IRequest;
|
|
43
|
+
|
|
44
|
+
/**
|
|
45
|
+
* Provides access to the underlying delta storage on the server for local driver.
|
|
46
|
+
*/
|
|
47
|
+
export declare class LocalDeltaStorageService implements IDocumentDeltaStorageService {
|
|
48
|
+
private readonly tenantId;
|
|
49
|
+
private readonly id;
|
|
50
|
+
private readonly databaseManager;
|
|
51
|
+
constructor(tenantId: string, id: string, databaseManager: IDatabaseManager);
|
|
52
|
+
fetchMessages(from: number, to: number | undefined, abortSignal?: AbortSignal, cachedOnly?: boolean): IStream<ISequencedDocumentMessage[]>;
|
|
53
|
+
private getCore;
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
/**
|
|
57
|
+
* Represents a connection to a stream of delta updates
|
|
58
|
+
*/
|
|
59
|
+
export declare class LocalDocumentDeltaConnection extends DocumentDeltaConnection {
|
|
60
|
+
/**
|
|
61
|
+
* Create a LocalDocumentDeltaConnection
|
|
62
|
+
* Handle initial messages, contents or signals if they were in queue
|
|
63
|
+
*
|
|
64
|
+
* @param tenantId - the ID of the tenant
|
|
65
|
+
* @param id - document ID
|
|
66
|
+
* @param token - authorization token for storage service
|
|
67
|
+
* @param client - information about the client
|
|
68
|
+
* @param webSocketServer - web socket server to create connection
|
|
69
|
+
*/
|
|
70
|
+
static create(tenantId: string, id: string, token: string, client: IClient, webSocketServer: IWebSocketServer, timeoutMs?: number, logger?: ITelemetryBaseLogger): Promise<LocalDocumentDeltaConnection>;
|
|
71
|
+
constructor(socket: Socket, documentId: string, logger?: ITelemetryBaseLogger);
|
|
72
|
+
/**
|
|
73
|
+
* Submits a new delta operation to the server
|
|
74
|
+
*/
|
|
75
|
+
submit(messages: IDocumentMessage[]): void;
|
|
76
|
+
/**
|
|
77
|
+
* Submits a new signal to the server
|
|
78
|
+
*/
|
|
79
|
+
submitSignal(message: any): void;
|
|
80
|
+
/**
|
|
81
|
+
* Send a "disconnect" message on the socket.
|
|
82
|
+
* @param disconnectReason - The reason of the disconnection.
|
|
83
|
+
*/
|
|
84
|
+
disconnectClient(disconnectReason: string): void;
|
|
85
|
+
/**
|
|
86
|
+
* * Sends a "nack" message on the socket.
|
|
87
|
+
* @param code - An error code number that represents the error. It will be a valid HTTP error code.
|
|
88
|
+
* @param type - Type of the Nack.
|
|
89
|
+
* @param message - A message about the nack for debugging/logging/telemetry purposes.
|
|
90
|
+
*/
|
|
91
|
+
nackClient(code: number | undefined, type: NackErrorType | undefined, message: any): void;
|
|
92
|
+
}
|
|
93
|
+
|
|
94
|
+
/**
|
|
95
|
+
* Basic implementation of a document service for local use.
|
|
96
|
+
*/
|
|
97
|
+
export declare class LocalDocumentService implements IDocumentService {
|
|
98
|
+
readonly resolvedUrl: IResolvedUrl;
|
|
99
|
+
private readonly localDeltaConnectionServer;
|
|
100
|
+
private readonly tokenProvider;
|
|
101
|
+
private readonly tenantId;
|
|
102
|
+
private readonly documentId;
|
|
103
|
+
private readonly documentDeltaConnectionsMap;
|
|
104
|
+
readonly policies: IDocumentServicePolicies;
|
|
105
|
+
private readonly innerDocumentService?;
|
|
106
|
+
private readonly logger?;
|
|
107
|
+
/**
|
|
108
|
+
* @param localDeltaConnectionServer - delta connection server for ops
|
|
109
|
+
* @param tokenProvider - token provider
|
|
110
|
+
* @param tenantId - ID of tenant
|
|
111
|
+
* @param documentId - ID of document
|
|
112
|
+
*/
|
|
113
|
+
constructor(resolvedUrl: IResolvedUrl, localDeltaConnectionServer: ILocalDeltaConnectionServer, tokenProvider: ITokenProvider, tenantId: string, documentId: string, documentDeltaConnectionsMap: Map<string, LocalDocumentDeltaConnection>, policies?: IDocumentServicePolicies, innerDocumentService?: IDocumentService | undefined, logger?: ITelemetryBaseLogger | undefined);
|
|
114
|
+
dispose(): void;
|
|
115
|
+
/**
|
|
116
|
+
* Creates and returns a document storage service for local use.
|
|
117
|
+
*/
|
|
118
|
+
connectToStorage(): Promise<IDocumentStorageService>;
|
|
119
|
+
/**
|
|
120
|
+
* Creates and returns a delta storage service for local use.
|
|
121
|
+
*/
|
|
122
|
+
connectToDeltaStorage(): Promise<IDocumentDeltaStorageService>;
|
|
123
|
+
/**
|
|
124
|
+
* Creates and returns a delta stream for local use.
|
|
125
|
+
* @param client - client data
|
|
126
|
+
*/
|
|
127
|
+
connectToDeltaStream(client: IClient): Promise<IDocumentDeltaConnection>;
|
|
128
|
+
}
|
|
129
|
+
|
|
130
|
+
/**
|
|
131
|
+
* Implementation of document service factory for local use.
|
|
132
|
+
*/
|
|
133
|
+
export declare class LocalDocumentServiceFactory implements IDocumentServiceFactory {
|
|
134
|
+
private readonly localDeltaConnectionServer;
|
|
135
|
+
private readonly policies?;
|
|
136
|
+
private readonly innerDocumentService?;
|
|
137
|
+
private readonly documentDeltaConnectionsMap;
|
|
138
|
+
/**
|
|
139
|
+
* @param localDeltaConnectionServer - delta connection server for ops
|
|
140
|
+
*/
|
|
141
|
+
constructor(localDeltaConnectionServer: ILocalDeltaConnectionServer, policies?: IDocumentServicePolicies | undefined, innerDocumentService?: IDocumentService | undefined);
|
|
142
|
+
createContainer(createNewSummary: ISummaryTree | undefined, resolvedUrl: IResolvedUrl, logger?: ITelemetryBaseLogger, clientIsSummarizer?: boolean): Promise<IDocumentService>;
|
|
143
|
+
/**
|
|
144
|
+
* Creates and returns a document service for testing using the given resolved
|
|
145
|
+
* URL for the tenant ID, document ID, and token.
|
|
146
|
+
* @param resolvedUrl - resolved URL of document
|
|
147
|
+
*/
|
|
148
|
+
createDocumentService(resolvedUrl: IResolvedUrl, logger?: ITelemetryBaseLogger, clientIsSummarizer?: boolean): Promise<IDocumentService>;
|
|
149
|
+
/**
|
|
150
|
+
* Gets the document delta connection for the clientId and asks it to disconnect the client.
|
|
151
|
+
* @param clientId - The ID of the client to be disconnected.
|
|
152
|
+
* @param disconnectReason - The reason of the disconnection.
|
|
153
|
+
*/
|
|
154
|
+
disconnectClient(clientId: string, disconnectReason: string): void;
|
|
155
|
+
/**
|
|
156
|
+
* Gets the document delta connection for the clientId and asks it to nack the client.
|
|
157
|
+
* @param clientId - The ID of the client to be Nack'd.
|
|
158
|
+
* @param code - An error code number that represents the error. It will be a valid HTTP error code.
|
|
159
|
+
* @param type - Type of the Nack.
|
|
160
|
+
* @param message - A message about the nack for debugging/logging/telemetry purposes.
|
|
161
|
+
*/
|
|
162
|
+
nackClient(clientId: string, code?: number, type?: NackErrorType, message?: any): void;
|
|
163
|
+
}
|
|
164
|
+
|
|
165
|
+
export declare class LocalDocumentStorageService implements IDocumentStorageService {
|
|
166
|
+
private readonly id;
|
|
167
|
+
private readonly manager;
|
|
168
|
+
readonly policies: IDocumentStorageServicePolicies;
|
|
169
|
+
private readonly localDeltaConnectionServer?;
|
|
170
|
+
private readonly resolvedUrl?;
|
|
171
|
+
protected readonly blobsShaCache: Map<string, string>;
|
|
172
|
+
private readonly summaryTreeUploadManager;
|
|
173
|
+
get repositoryUrl(): string;
|
|
174
|
+
constructor(id: string, manager: GitManager, policies: IDocumentStorageServicePolicies, localDeltaConnectionServer?: ILocalDeltaConnectionServer | undefined, resolvedUrl?: IResolvedUrl | undefined);
|
|
175
|
+
getVersions(versionId: string | null, count: number): Promise<IVersion[]>;
|
|
176
|
+
getSnapshotTree(version?: IVersion): Promise<ISnapshotTreeEx | null>;
|
|
177
|
+
readBlob(blobId: string): Promise<ArrayBufferLike>;
|
|
178
|
+
uploadSummaryWithContext(summary: ISummaryTree, context: ISummaryContext): Promise<string>;
|
|
179
|
+
createBlob(file: ArrayBufferLike): Promise<ICreateBlobResponse>;
|
|
180
|
+
downloadSummary(handle: ISummaryHandle): Promise<ISummaryTree>;
|
|
181
|
+
private getPreviousFullSnapshot;
|
|
182
|
+
}
|
|
183
|
+
|
|
184
|
+
/**
|
|
185
|
+
* Resolves URLs by providing fake URLs which succeed with the other
|
|
186
|
+
* related local classes.
|
|
187
|
+
*/
|
|
188
|
+
export declare class LocalResolver implements IUrlResolver {
|
|
189
|
+
private readonly tenantId;
|
|
190
|
+
private readonly tokenKey;
|
|
191
|
+
constructor();
|
|
192
|
+
/**
|
|
193
|
+
* Resolves URL requests by providing fake URLs with an actually generated
|
|
194
|
+
* token from constant test strings. The root of the URL is fake, but the
|
|
195
|
+
* remaining relative URL can still be parsed.
|
|
196
|
+
* @param request - request to handle
|
|
197
|
+
*/
|
|
198
|
+
resolve(request: IRequest): Promise<IResolvedUrl>;
|
|
199
|
+
getAbsoluteUrl(resolvedUrl: IResolvedUrl, relativeUrl: string): Promise<string>;
|
|
200
|
+
createCreateNewRequest(documentId: string): IRequest;
|
|
201
|
+
}
|
|
202
|
+
|
|
203
|
+
/**
|
|
204
|
+
* A database factory for testing that stores data in the browsers session storage
|
|
205
|
+
*/
|
|
206
|
+
export declare class LocalSessionStorageDbFactory implements ITestDbFactory {
|
|
207
|
+
readonly testDatabase: IDb;
|
|
208
|
+
connect(): Promise<IDb>;
|
|
209
|
+
}
|
|
210
|
+
|
|
211
|
+
export { }
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"localDocumentStorageService.d.ts","sourceRoot":"","sources":["../src/localDocumentStorageService.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACN,uBAAuB,EACvB,+BAA+B,EAC/B,YAAY,EACZ,eAAe,EACf,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACN,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,YAAY,EACZ,QAAQ,EACR,MAAM,sCAAsC,CAAC;AAE9C,OAAO,EACN,UAAU,EAGV,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAIlF,qBAAa,2BAA4B,YAAW,uBAAuB;
|
|
1
|
+
{"version":3,"file":"localDocumentStorageService.d.ts","sourceRoot":"","sources":["../src/localDocumentStorageService.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACN,uBAAuB,EACvB,+BAA+B,EAC/B,YAAY,EACZ,eAAe,EACf,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACN,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,YAAY,EACZ,QAAQ,EACR,MAAM,sCAAsC,CAAC;AAE9C,OAAO,EACN,UAAU,EAGV,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAIlF,qBAAa,2BAA4B,YAAW,uBAAuB;IAYzE,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,OAAO;aACR,QAAQ,EAAE,+BAA+B;IACzD,OAAO,CAAC,QAAQ,CAAC,0BAA0B,CAAC;IAC5C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;IAb9B,SAAS,CAAC,QAAQ,CAAC,aAAa,sBAA6B;IAC7D,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAwB;IAGjE,IAAW,aAAa,IAAI,MAAM,CAEjC;gBAGiB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,UAAU,EACpB,QAAQ,EAAE,+BAA+B,EACxC,0BAA0B,CAAC,yCAA6B,EACxD,WAAW,CAAC,0BAAc;IAS/B,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAUzE,eAAe,CAAC,OAAO,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAgBpE,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAOlD,wBAAwB,CACpC,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,eAAe,GACtB,OAAO,CAAC,MAAM,CAAC;IAkBL,UAAU,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAO/D,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC;YAI7D,uBAAuB;CAWrC"}
|
|
@@ -11,6 +11,7 @@ const server_services_client_1 = require("@fluidframework/server-services-client
|
|
|
11
11
|
const localCreateDocument_1 = require("./localCreateDocument");
|
|
12
12
|
const minTTLInSeconds = 24 * 60 * 60; // Same TTL as ODSP
|
|
13
13
|
class LocalDocumentStorageService {
|
|
14
|
+
// eslint-disable-next-line @typescript-eslint/class-literal-property-style
|
|
14
15
|
get repositoryUrl() {
|
|
15
16
|
return "";
|
|
16
17
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"localDocumentStorageService.js","sourceRoot":"","sources":["../src/localDocumentStorageService.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,+DAAkF;AAclF,iEAAsE;AACtE,mFAIgD;AAEhD,+DAAuD;AAEvD,MAAM,eAAe,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,mBAAmB;AACzD,MAAa,2BAA2B;IAMvC,IAAW,aAAa;QACvB,OAAO,EAAE,CAAC;IACX,CAAC;IAED,YACkB,EAAU,EACV,OAAmB,EACpB,QAAyC,EACxC,0BAAwD,EACxD,WAA0B;QAJ1B,OAAE,GAAF,EAAE,CAAQ;QACV,YAAO,GAAP,OAAO,CAAY;QACpB,aAAQ,GAAR,QAAQ,CAAiC;QACxC,+BAA0B,GAA1B,0BAA0B,CAA8B;QACxD,gBAAW,GAAX,WAAW,CAAe;
|
|
1
|
+
{"version":3,"file":"localDocumentStorageService.js","sourceRoot":"","sources":["../src/localDocumentStorageService.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,+DAAkF;AAclF,iEAAsE;AACtE,mFAIgD;AAEhD,+DAAuD;AAEvD,MAAM,eAAe,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,mBAAmB;AACzD,MAAa,2BAA2B;IAMvC,2EAA2E;IAC3E,IAAW,aAAa;QACvB,OAAO,EAAE,CAAC;IACX,CAAC;IAED,YACkB,EAAU,EACV,OAAmB,EACpB,QAAyC,EACxC,0BAAwD,EACxD,WAA0B;QAJ1B,OAAE,GAAF,EAAE,CAAQ;QACV,YAAO,GAAP,OAAO,CAAY;QACpB,aAAQ,GAAR,QAAQ,CAAiC;QACxC,+BAA0B,GAA1B,0BAA0B,CAA8B;QACxD,gBAAW,GAAX,WAAW,CAAe;QAf5C,uFAAuF;QACvF,2BAA2B;QACR,kBAAa,GAAG,IAAI,GAAG,EAAkB,CAAC;QAe5D,IAAI,CAAC,wBAAwB,GAAG,IAAI,iDAAwB,CAC3D,OAAO,EACP,IAAI,CAAC,aAAa,EAClB,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,CACvC,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,WAAW,CAAC,SAAwB,EAAE,KAAa;QAC/D,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QACzD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI;YAC/B,EAAE,EAAE,MAAM,CAAC,GAAG;YACd,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG;SAC9B,CAAC,CAAC,CAAC;IACL,CAAC;IAEM,KAAK,CAAC,eAAe,CAAC,OAAkB;QAC9C,IAAI,cAAc,GAAG,OAAO,CAAC;QAC7B,IAAI,CAAC,cAAc,EAAE;YACpB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;YACpD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE;gBAC1B,OAAO,IAAI,CAAC;aACZ;YAED,cAAc,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;SAC7B;QAED,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QAClE,MAAM,IAAI,GAAG,IAAA,qCAAqB,EAAC,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;QACtE,OAAO,IAAI,CAAC;IACb,CAAC;IAEM,KAAK,CAAC,QAAQ,CAAC,MAAc;QACnC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAChD,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACrC,MAAM,aAAa,GAAG,IAAA,6BAAc,EAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAClE,OAAO,aAAa,CAAC;IACtB,CAAC;IAEM,KAAK,CAAC,wBAAwB,CACpC,OAAqB,EACrB,OAAwB;QAExB,IAAI,OAAO,CAAC,uBAAuB,KAAK,CAAC,EAAE;YAC1C,IAAI,IAAI,CAAC,0BAA0B,KAAK,SAAS,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,EAAE;gBACpF,MAAM,IAAI,KAAK,CACd,+FAA+F,CAC/F,CAAC;aACF;YACD,MAAM,IAAA,oCAAc,EAAC,IAAI,CAAC,0BAA0B,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YACjF,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;YACnD,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;SACrB;QACD,OAAO,IAAI,CAAC,wBAAwB,CAAC,gBAAgB,CACpD,OAAO,EACP,OAAO,CAAC,SAAS,IAAI,EAAE,EACvB,SAAS,CACT,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,UAAU,CAAC,IAAqB;QAC5C,MAAM,cAAc,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC,OAAO;aACjB,UAAU,CAAC,IAAA,iCAAkB,EAAC,cAAc,EAAE,QAAQ,CAAC,EAAE,QAAQ,CAAC;aAClE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC;IAC7D,CAAC;IAEM,KAAK,CAAC,eAAe,CAAC,MAAsB;QAClD,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACrC,CAAC;IAEO,KAAK,CAAC,uBAAuB,CACpC,YAAoB;QAEpB,OAAO,YAAY;YAClB,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;gBAC1D,mEAAmE;gBACnE,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;gBAC3B,OAAO,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;YACzC,CAAC,CAAC;YACJ,CAAC,CAAC,SAAS,CAAC;IACd,CAAC;CACD;AArGD,kEAqGC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport { stringToBuffer, Uint8ArrayToString } from \"@fluid-internal/client-utils\";\nimport {\n\tIDocumentStorageService,\n\tIDocumentStorageServicePolicies,\n\tIResolvedUrl,\n\tISummaryContext,\n} from \"@fluidframework/driver-definitions\";\nimport {\n\tICreateBlobResponse,\n\tISnapshotTreeEx,\n\tISummaryHandle,\n\tISummaryTree,\n\tIVersion,\n} from \"@fluidframework/protocol-definitions\";\nimport { buildGitTreeHierarchy } from \"@fluidframework/protocol-base\";\nimport {\n\tGitManager,\n\tISummaryUploadManager,\n\tSummaryTreeUploadManager,\n} from \"@fluidframework/server-services-client\";\nimport { ILocalDeltaConnectionServer } from \"@fluidframework/server-local-server\";\nimport { createDocument } from \"./localCreateDocument\";\n\nconst minTTLInSeconds = 24 * 60 * 60; // Same TTL as ODSP\nexport class LocalDocumentStorageService implements IDocumentStorageService {\n\t// The values of this cache is useless. We only need the keys. So we are always putting\n\t// empty strings as values.\n\tprotected readonly blobsShaCache = new Map<string, string>();\n\tprivate readonly summaryTreeUploadManager: ISummaryUploadManager;\n\n\t// eslint-disable-next-line @typescript-eslint/class-literal-property-style\n\tpublic get repositoryUrl(): string {\n\t\treturn \"\";\n\t}\n\n\tconstructor(\n\t\tprivate readonly id: string,\n\t\tprivate readonly manager: GitManager,\n\t\tpublic readonly policies: IDocumentStorageServicePolicies,\n\t\tprivate readonly localDeltaConnectionServer?: ILocalDeltaConnectionServer,\n\t\tprivate readonly resolvedUrl?: IResolvedUrl,\n\t) {\n\t\tthis.summaryTreeUploadManager = new SummaryTreeUploadManager(\n\t\t\tmanager,\n\t\t\tthis.blobsShaCache,\n\t\t\tthis.getPreviousFullSnapshot.bind(this),\n\t\t);\n\t}\n\n\tpublic async getVersions(versionId: string | null, count: number): Promise<IVersion[]> {\n\t\tconst id = versionId ? versionId : this.id;\n\t\tconst commits = await this.manager.getCommits(id, count);\n\t\treturn commits.map((commit) => ({\n\t\t\tdate: commit.commit.author.date,\n\t\t\tid: commit.sha,\n\t\t\ttreeId: commit.commit.tree.sha,\n\t\t}));\n\t}\n\n\tpublic async getSnapshotTree(version?: IVersion): Promise<ISnapshotTreeEx | null> {\n\t\tlet requestVersion = version;\n\t\tif (!requestVersion) {\n\t\t\tconst versions = await this.getVersions(this.id, 1);\n\t\t\tif (versions.length === 0) {\n\t\t\t\treturn null;\n\t\t\t}\n\n\t\t\trequestVersion = versions[0];\n\t\t}\n\n\t\tconst rawTree = await this.manager.getTree(requestVersion.treeId);\n\t\tconst tree = buildGitTreeHierarchy(rawTree, this.blobsShaCache, true);\n\t\treturn tree;\n\t}\n\n\tpublic async readBlob(blobId: string): Promise<ArrayBufferLike> {\n\t\tconst blob = await this.manager.getBlob(blobId);\n\t\tthis.blobsShaCache.set(blob.sha, \"\");\n\t\tconst bufferContent = stringToBuffer(blob.content, blob.encoding);\n\t\treturn bufferContent;\n\t}\n\n\tpublic async uploadSummaryWithContext(\n\t\tsummary: ISummaryTree,\n\t\tcontext: ISummaryContext,\n\t): Promise<string> {\n\t\tif (context.referenceSequenceNumber === 0) {\n\t\t\tif (this.localDeltaConnectionServer === undefined || this.resolvedUrl === undefined) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t\"Insufficient constructor parameters. An ILocalDeltaConnectionServer and IResolvedUrl required\",\n\t\t\t\t);\n\t\t\t}\n\t\t\tawait createDocument(this.localDeltaConnectionServer, this.resolvedUrl, summary);\n\t\t\tconst version = await this.getVersions(this.id, 1);\n\t\t\treturn version[0].id;\n\t\t}\n\t\treturn this.summaryTreeUploadManager.writeSummaryTree(\n\t\t\tsummary,\n\t\t\tcontext.ackHandle ?? \"\",\n\t\t\t\"channel\",\n\t\t);\n\t}\n\n\tpublic async createBlob(file: ArrayBufferLike): Promise<ICreateBlobResponse> {\n\t\tconst uint8ArrayFile = new Uint8Array(file);\n\t\treturn this.manager\n\t\t\t.createBlob(Uint8ArrayToString(uint8ArrayFile, \"base64\"), \"base64\")\n\t\t\t.then((r) => ({ id: r.sha, url: r.url, minTTLInSeconds }));\n\t}\n\n\tpublic async downloadSummary(handle: ISummaryHandle): Promise<ISummaryTree> {\n\t\tthrow new Error(\"NOT IMPLEMENTED!\");\n\t}\n\n\tprivate async getPreviousFullSnapshot(\n\t\tparentHandle: string,\n\t): Promise<ISnapshotTreeEx | null | undefined> {\n\t\treturn parentHandle\n\t\t\t? this.getVersions(parentHandle, 1).then(async (versions) => {\n\t\t\t\t\t// Clear the cache as the getSnapshotTree call will fill the cache.\n\t\t\t\t\tthis.blobsShaCache.clear();\n\t\t\t\t\treturn this.getSnapshotTree(versions[0]);\n\t\t\t })\n\t\t\t: undefined;\n\t}\n}\n"]}
|
package/dist/tsdoc-metadata.json
CHANGED
package/lib/auth.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAgB,KAAK,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;
|
|
1
|
+
{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAgB,KAAK,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AAItF;;;GAGG;AACH,wBAAgB,aAAa,CAC5B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,SAAS,EAAE,EACnB,IAAI,CAAC,EAAE,KAAK,EACZ,QAAQ,GAAE,MAAgB,EAC1B,GAAG,GAAE,MAAc,GACjB,MAAM,CA0BR;AAED,wBAAgB,YAAY,IAAI,KAAK,CAWpC"}
|
package/lib/auth.js
CHANGED
|
@@ -4,7 +4,6 @@
|
|
|
4
4
|
*/
|
|
5
5
|
import { KJUR as jsrsasign } from "jsrsasign";
|
|
6
6
|
import { v4 as uuid } from "uuid";
|
|
7
|
-
import { getRandomName } from "@fluidframework/server-services-client";
|
|
8
7
|
/**
|
|
9
8
|
* Generates a JWT token to authorize against. We do not use the implementation in
|
|
10
9
|
* services-client since it cannot run in the browser without polyfills.
|
|
@@ -29,9 +28,12 @@ export function generateToken(tenantId, documentId, key, scopes, user, lifetime
|
|
|
29
28
|
return jsrsasign.jws.JWS.sign(null, JSON.stringify({ alg: "HS256", typ: "JWT" }), claims, utf8Key);
|
|
30
29
|
}
|
|
31
30
|
export function generateUser() {
|
|
31
|
+
const userId = uuid();
|
|
32
|
+
const match = userId.match(/^([\da-f]{8})-([\da-f]{4})/);
|
|
33
|
+
const userName = match !== null ? match[0] : userId; // Just use the first two segments of the (fake) userId as a fake name.
|
|
32
34
|
const randomUser = {
|
|
33
|
-
id:
|
|
34
|
-
name:
|
|
35
|
+
id: userId,
|
|
36
|
+
name: userName,
|
|
35
37
|
};
|
|
36
38
|
return randomUser;
|
|
37
39
|
}
|
package/lib/auth.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,IAAI,IAAI,SAAS,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,EAAE,IAAI,IAAI,EAAE,MAAM,MAAM,CAAC;
|
|
1
|
+
{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,IAAI,IAAI,SAAS,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,EAAE,IAAI,IAAI,EAAE,MAAM,MAAM,CAAC;AAElC;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC5B,QAAgB,EAChB,UAAkB,EAClB,GAAW,EACX,MAAmB,EACnB,IAAY,EACZ,WAAmB,EAAE,GAAG,EAAE,EAC1B,MAAc,KAAK;IAEnB,IAAI,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC;IAC7C,IAAI,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,SAAS,CAAC,EAAE,KAAK,SAAS,EAAE;QACtD,SAAS,GAAG,YAAY,EAAE,CAAC;KAC3B;IAED,0BAA0B;IAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IAEpD,MAAM,MAAM,GAAiB;QAC5B,UAAU;QACV,MAAM;QACN,QAAQ;QACR,IAAI,EAAE,SAAS;QACf,GAAG,EAAE,GAAG;QACR,GAAG,EAAE,GAAG,GAAG,QAAQ;QACnB,GAAG;KACH,CAAC;IAEF,MAAM,OAAO,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;IAC9B,OAAO,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAC5B,IAAI,EACJ,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,EAC5C,MAAM,EACN,OAAO,CACP,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY;IAC3B,MAAM,MAAM,GAAG,IAAI,EAAE,CAAC;IACtB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;IACzD,MAAM,QAAQ,GAAG,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,uEAAuE;IAE5H,MAAM,UAAU,GAAG;QAClB,EAAE,EAAE,MAAM;QACV,IAAI,EAAE,QAAQ;KACd,CAAC;IAEF,OAAO,UAAU,CAAC;AACnB,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport { ITokenClaims, IUser, ScopeType } from \"@fluidframework/protocol-definitions\";\nimport { KJUR as jsrsasign } from \"jsrsasign\";\nimport { v4 as uuid } from \"uuid\";\n\n/**\n * Generates a JWT token to authorize against. We do not use the implementation in\n * services-client since it cannot run in the browser without polyfills.\n */\nexport function generateToken(\n\ttenantId: string,\n\tdocumentId: string,\n\tkey: string,\n\tscopes: ScopeType[],\n\tuser?: IUser,\n\tlifetime: number = 60 * 60,\n\tver: string = \"1.0\",\n): string {\n\tlet userClaim = user ? user : generateUser();\n\tif (userClaim.id === \"\" || userClaim.id === undefined) {\n\t\tuserClaim = generateUser();\n\t}\n\n\t// Current time in seconds\n\tconst now = Math.round(new Date().getTime() / 1000);\n\n\tconst claims: ITokenClaims = {\n\t\tdocumentId,\n\t\tscopes,\n\t\ttenantId,\n\t\tuser: userClaim,\n\t\tiat: now,\n\t\texp: now + lifetime,\n\t\tver,\n\t};\n\n\tconst utf8Key = { utf8: key };\n\treturn jsrsasign.jws.JWS.sign(\n\t\tnull,\n\t\tJSON.stringify({ alg: \"HS256\", typ: \"JWT\" }),\n\t\tclaims,\n\t\tutf8Key,\n\t);\n}\n\nexport function generateUser(): IUser {\n\tconst userId = uuid();\n\tconst match = userId.match(/^([\\da-f]{8})-([\\da-f]{4})/);\n\tconst userName = match !== null ? match[0] : userId; // Just use the first two segments of the (fake) userId as a fake name.\n\n\tconst randomUser = {\n\t\tid: userId,\n\t\tname: userName,\n\t};\n\n\treturn randomUser;\n}\n"]}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"localDocumentStorageService.d.ts","sourceRoot":"","sources":["../src/localDocumentStorageService.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACN,uBAAuB,EACvB,+BAA+B,EAC/B,YAAY,EACZ,eAAe,EACf,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACN,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,YAAY,EACZ,QAAQ,EACR,MAAM,sCAAsC,CAAC;AAE9C,OAAO,EACN,UAAU,EAGV,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAIlF,qBAAa,2BAA4B,YAAW,uBAAuB;
|
|
1
|
+
{"version":3,"file":"localDocumentStorageService.d.ts","sourceRoot":"","sources":["../src/localDocumentStorageService.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACN,uBAAuB,EACvB,+BAA+B,EAC/B,YAAY,EACZ,eAAe,EACf,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACN,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,YAAY,EACZ,QAAQ,EACR,MAAM,sCAAsC,CAAC;AAE9C,OAAO,EACN,UAAU,EAGV,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAIlF,qBAAa,2BAA4B,YAAW,uBAAuB;IAYzE,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,OAAO;aACR,QAAQ,EAAE,+BAA+B;IACzD,OAAO,CAAC,QAAQ,CAAC,0BAA0B,CAAC;IAC5C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;IAb9B,SAAS,CAAC,QAAQ,CAAC,aAAa,sBAA6B;IAC7D,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAwB;IAGjE,IAAW,aAAa,IAAI,MAAM,CAEjC;gBAGiB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,UAAU,EACpB,QAAQ,EAAE,+BAA+B,EACxC,0BAA0B,CAAC,yCAA6B,EACxD,WAAW,CAAC,0BAAc;IAS/B,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAUzE,eAAe,CAAC,OAAO,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAgBpE,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAOlD,wBAAwB,CACpC,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,eAAe,GACtB,OAAO,CAAC,MAAM,CAAC;IAkBL,UAAU,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAO/D,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC;YAI7D,uBAAuB;CAWrC"}
|
|
@@ -8,6 +8,7 @@ import { SummaryTreeUploadManager, } from "@fluidframework/server-services-clien
|
|
|
8
8
|
import { createDocument } from "./localCreateDocument";
|
|
9
9
|
const minTTLInSeconds = 24 * 60 * 60; // Same TTL as ODSP
|
|
10
10
|
export class LocalDocumentStorageService {
|
|
11
|
+
// eslint-disable-next-line @typescript-eslint/class-literal-property-style
|
|
11
12
|
get repositoryUrl() {
|
|
12
13
|
return "";
|
|
13
14
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"localDocumentStorageService.js","sourceRoot":"","sources":["../src/localDocumentStorageService.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAclF,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAGN,wBAAwB,GACxB,MAAM,wCAAwC,CAAC;AAEhD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,eAAe,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,mBAAmB;AACzD,MAAM,OAAO,2BAA2B;IAMvC,IAAW,aAAa;QACvB,OAAO,EAAE,CAAC;IACX,CAAC;IAED,YACkB,EAAU,EACV,OAAmB,EACpB,QAAyC,EACxC,0BAAwD,EACxD,WAA0B;QAJ1B,OAAE,GAAF,EAAE,CAAQ;QACV,YAAO,GAAP,OAAO,CAAY;QACpB,aAAQ,GAAR,QAAQ,CAAiC;QACxC,+BAA0B,GAA1B,0BAA0B,CAA8B;QACxD,gBAAW,GAAX,WAAW,CAAe;
|
|
1
|
+
{"version":3,"file":"localDocumentStorageService.js","sourceRoot":"","sources":["../src/localDocumentStorageService.ts"],"names":[],"mappings":"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","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport { stringToBuffer, Uint8ArrayToString } from \"@fluid-internal/client-utils\";\nimport {\n\tIDocumentStorageService,\n\tIDocumentStorageServicePolicies,\n\tIResolvedUrl,\n\tISummaryContext,\n} from \"@fluidframework/driver-definitions\";\nimport {\n\tICreateBlobResponse,\n\tISnapshotTreeEx,\n\tISummaryHandle,\n\tISummaryTree,\n\tIVersion,\n} from \"@fluidframework/protocol-definitions\";\nimport { buildGitTreeHierarchy } from \"@fluidframework/protocol-base\";\nimport {\n\tGitManager,\n\tISummaryUploadManager,\n\tSummaryTreeUploadManager,\n} from \"@fluidframework/server-services-client\";\nimport { ILocalDeltaConnectionServer } from \"@fluidframework/server-local-server\";\nimport { createDocument } from \"./localCreateDocument\";\n\nconst minTTLInSeconds = 24 * 60 * 60; // Same TTL as ODSP\nexport class LocalDocumentStorageService implements IDocumentStorageService {\n\t// The values of this cache is useless. We only need the keys. So we are always putting\n\t// empty strings as values.\n\tprotected readonly blobsShaCache = new Map<string, string>();\n\tprivate readonly summaryTreeUploadManager: ISummaryUploadManager;\n\n\t// eslint-disable-next-line @typescript-eslint/class-literal-property-style\n\tpublic get repositoryUrl(): string {\n\t\treturn \"\";\n\t}\n\n\tconstructor(\n\t\tprivate readonly id: string,\n\t\tprivate readonly manager: GitManager,\n\t\tpublic readonly policies: IDocumentStorageServicePolicies,\n\t\tprivate readonly localDeltaConnectionServer?: ILocalDeltaConnectionServer,\n\t\tprivate readonly resolvedUrl?: IResolvedUrl,\n\t) {\n\t\tthis.summaryTreeUploadManager = new SummaryTreeUploadManager(\n\t\t\tmanager,\n\t\t\tthis.blobsShaCache,\n\t\t\tthis.getPreviousFullSnapshot.bind(this),\n\t\t);\n\t}\n\n\tpublic async getVersions(versionId: string | null, count: number): Promise<IVersion[]> {\n\t\tconst id = versionId ? versionId : this.id;\n\t\tconst commits = await this.manager.getCommits(id, count);\n\t\treturn commits.map((commit) => ({\n\t\t\tdate: commit.commit.author.date,\n\t\t\tid: commit.sha,\n\t\t\ttreeId: commit.commit.tree.sha,\n\t\t}));\n\t}\n\n\tpublic async getSnapshotTree(version?: IVersion): Promise<ISnapshotTreeEx | null> {\n\t\tlet requestVersion = version;\n\t\tif (!requestVersion) {\n\t\t\tconst versions = await this.getVersions(this.id, 1);\n\t\t\tif (versions.length === 0) {\n\t\t\t\treturn null;\n\t\t\t}\n\n\t\t\trequestVersion = versions[0];\n\t\t}\n\n\t\tconst rawTree = await this.manager.getTree(requestVersion.treeId);\n\t\tconst tree = buildGitTreeHierarchy(rawTree, this.blobsShaCache, true);\n\t\treturn tree;\n\t}\n\n\tpublic async readBlob(blobId: string): Promise<ArrayBufferLike> {\n\t\tconst blob = await this.manager.getBlob(blobId);\n\t\tthis.blobsShaCache.set(blob.sha, \"\");\n\t\tconst bufferContent = stringToBuffer(blob.content, blob.encoding);\n\t\treturn bufferContent;\n\t}\n\n\tpublic async uploadSummaryWithContext(\n\t\tsummary: ISummaryTree,\n\t\tcontext: ISummaryContext,\n\t): Promise<string> {\n\t\tif (context.referenceSequenceNumber === 0) {\n\t\t\tif (this.localDeltaConnectionServer === undefined || this.resolvedUrl === undefined) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t\"Insufficient constructor parameters. An ILocalDeltaConnectionServer and IResolvedUrl required\",\n\t\t\t\t);\n\t\t\t}\n\t\t\tawait createDocument(this.localDeltaConnectionServer, this.resolvedUrl, summary);\n\t\t\tconst version = await this.getVersions(this.id, 1);\n\t\t\treturn version[0].id;\n\t\t}\n\t\treturn this.summaryTreeUploadManager.writeSummaryTree(\n\t\t\tsummary,\n\t\t\tcontext.ackHandle ?? \"\",\n\t\t\t\"channel\",\n\t\t);\n\t}\n\n\tpublic async createBlob(file: ArrayBufferLike): Promise<ICreateBlobResponse> {\n\t\tconst uint8ArrayFile = new Uint8Array(file);\n\t\treturn this.manager\n\t\t\t.createBlob(Uint8ArrayToString(uint8ArrayFile, \"base64\"), \"base64\")\n\t\t\t.then((r) => ({ id: r.sha, url: r.url, minTTLInSeconds }));\n\t}\n\n\tpublic async downloadSummary(handle: ISummaryHandle): Promise<ISummaryTree> {\n\t\tthrow new Error(\"NOT IMPLEMENTED!\");\n\t}\n\n\tprivate async getPreviousFullSnapshot(\n\t\tparentHandle: string,\n\t): Promise<ISnapshotTreeEx | null | undefined> {\n\t\treturn parentHandle\n\t\t\t? this.getVersions(parentHandle, 1).then(async (versions) => {\n\t\t\t\t\t// Clear the cache as the getSnapshotTree call will fill the cache.\n\t\t\t\t\tthis.blobsShaCache.clear();\n\t\t\t\t\treturn this.getSnapshotTree(versions[0]);\n\t\t\t })\n\t\t\t: undefined;\n\t}\n}\n"]}
|