pyric-admin 0.1.0-alpha.22 → 0.1.0-alpha.25

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 (129) hide show
  1. package/README.md +13 -5
  2. package/dist/admin.d.ts +64 -12
  3. package/dist/admin.d.ts.map +1 -1
  4. package/dist/admin.js +53 -8
  5. package/dist/admin.js.map +1 -1
  6. package/dist/app/index.d.ts +14 -1
  7. package/dist/app/index.d.ts.map +1 -1
  8. package/dist/app/index.js +58 -16
  9. package/dist/app/index.js.map +1 -1
  10. package/dist/app-check/index.d.ts +15 -0
  11. package/dist/app-check/index.d.ts.map +1 -0
  12. package/dist/app-check/index.js +16 -0
  13. package/dist/app-check/index.js.map +1 -0
  14. package/dist/auth/index.d.ts.map +1 -1
  15. package/dist/auth/index.js +11 -0
  16. package/dist/auth/index.js.map +1 -1
  17. package/dist/data-connect/index.d.ts +25 -0
  18. package/dist/data-connect/index.d.ts.map +1 -0
  19. package/dist/data-connect/index.js +48 -0
  20. package/dist/data-connect/index.js.map +1 -0
  21. package/dist/database/index.d.ts +24 -19
  22. package/dist/database/index.d.ts.map +1 -1
  23. package/dist/database/index.js +133 -99
  24. package/dist/database/index.js.map +1 -1
  25. package/dist/deferred.d.ts +45 -0
  26. package/dist/deferred.d.ts.map +1 -0
  27. package/dist/deferred.js +71 -0
  28. package/dist/deferred.js.map +1 -0
  29. package/dist/eventarc/index.d.ts +15 -0
  30. package/dist/eventarc/index.d.ts.map +1 -0
  31. package/dist/eventarc/index.js +17 -0
  32. package/dist/eventarc/index.js.map +1 -0
  33. package/dist/extensions/index.d.ts +15 -0
  34. package/dist/extensions/index.d.ts.map +1 -0
  35. package/dist/extensions/index.js +17 -0
  36. package/dist/extensions/index.js.map +1 -0
  37. package/dist/firestore/index.d.ts +6 -0
  38. package/dist/firestore/index.d.ts.map +1 -1
  39. package/dist/firestore/index.js +25 -3
  40. package/dist/firestore/index.js.map +1 -1
  41. package/dist/functions/index.d.ts +15 -0
  42. package/dist/functions/index.d.ts.map +1 -0
  43. package/dist/functions/index.js +17 -0
  44. package/dist/functions/index.js.map +1 -0
  45. package/dist/installations/index.d.ts +15 -0
  46. package/dist/installations/index.d.ts.map +1 -0
  47. package/dist/installations/index.js +17 -0
  48. package/dist/installations/index.js.map +1 -0
  49. package/dist/instance-id/index.d.ts +15 -0
  50. package/dist/instance-id/index.d.ts.map +1 -0
  51. package/dist/instance-id/index.js +17 -0
  52. package/dist/instance-id/index.js.map +1 -0
  53. package/dist/machine-learning/index.d.ts +21 -0
  54. package/dist/machine-learning/index.d.ts.map +1 -0
  55. package/dist/machine-learning/index.js +25 -0
  56. package/dist/machine-learning/index.js.map +1 -0
  57. package/dist/messaging/index.d.ts +0 -1
  58. package/dist/messaging/index.d.ts.map +1 -1
  59. package/dist/messaging/index.js +8 -8
  60. package/dist/messaging/index.js.map +1 -1
  61. package/dist/phone-number-verification/index.d.ts +14 -0
  62. package/dist/phone-number-verification/index.d.ts.map +1 -0
  63. package/dist/phone-number-verification/index.js +16 -0
  64. package/dist/phone-number-verification/index.js.map +1 -0
  65. package/dist/project-management/index.d.ts +23 -0
  66. package/dist/project-management/index.d.ts.map +1 -0
  67. package/dist/project-management/index.js +25 -0
  68. package/dist/project-management/index.js.map +1 -0
  69. package/dist/remote-config/index.d.ts +23 -0
  70. package/dist/remote-config/index.d.ts.map +1 -0
  71. package/dist/remote-config/index.js +26 -0
  72. package/dist/remote-config/index.js.map +1 -0
  73. package/dist/security-rules/index.d.ts +25 -0
  74. package/dist/security-rules/index.d.ts.map +1 -0
  75. package/dist/security-rules/index.js +29 -0
  76. package/dist/security-rules/index.js.map +1 -0
  77. package/dist/storage/deferred-members.d.ts +14 -0
  78. package/dist/storage/deferred-members.d.ts.map +1 -0
  79. package/dist/storage/deferred-members.js +55 -0
  80. package/dist/storage/deferred-members.js.map +1 -0
  81. package/dist/storage/delete-files.d.ts +13 -0
  82. package/dist/storage/delete-files.d.ts.map +1 -0
  83. package/dist/storage/delete-files.js +39 -0
  84. package/dist/storage/delete-files.js.map +1 -0
  85. package/dist/storage/file-query.d.ts +52 -0
  86. package/dist/storage/file-query.d.ts.map +1 -0
  87. package/dist/storage/file-query.js +94 -0
  88. package/dist/storage/file-query.js.map +1 -0
  89. package/dist/storage/get-files.d.ts +15 -0
  90. package/dist/storage/get-files.d.ts.map +1 -0
  91. package/dist/storage/get-files.js +33 -0
  92. package/dist/storage/get-files.js.map +1 -0
  93. package/dist/storage/index.d.ts +159 -23
  94. package/dist/storage/index.d.ts.map +1 -1
  95. package/dist/storage/index.js +688 -149
  96. package/dist/storage/index.js.map +1 -1
  97. package/dist/storage/remote-names.d.ts +19 -0
  98. package/dist/storage/remote-names.d.ts.map +1 -0
  99. package/dist/storage/remote-names.js +26 -0
  100. package/dist/storage/remote-names.js.map +1 -0
  101. package/package.json +50 -2
  102. package/src/admin.ts +58 -8
  103. package/src/app/index.ts +71 -19
  104. package/src/app-check/index.ts +32 -0
  105. package/src/auth/auth.test.ts +27 -0
  106. package/src/auth/index.ts +8 -0
  107. package/src/data-connect/index.ts +75 -0
  108. package/src/database/database.test.ts +1 -0
  109. package/src/database/index.ts +182 -108
  110. package/src/deferred.ts +96 -0
  111. package/src/eventarc/index.ts +37 -0
  112. package/src/extensions/index.ts +37 -0
  113. package/src/firestore/index.ts +30 -3
  114. package/src/functions/index.ts +37 -0
  115. package/src/installations/index.ts +38 -0
  116. package/src/instance-id/index.ts +38 -0
  117. package/src/machine-learning/index.ts +51 -0
  118. package/src/messaging/index.ts +3 -9
  119. package/src/phone-number-verification/index.ts +36 -0
  120. package/src/project-management/index.ts +55 -0
  121. package/src/remote-config/index.ts +58 -0
  122. package/src/security-rules/index.ts +59 -0
  123. package/src/storage/deferred-members.ts +67 -0
  124. package/src/storage/delete-files.ts +40 -0
  125. package/src/storage/file-query.ts +135 -0
  126. package/src/storage/get-files.ts +40 -0
  127. package/src/storage/index.ts +918 -183
  128. package/src/storage/remote-names.ts +34 -0
  129. package/src/storage/storage.test.ts +78 -5
@@ -48,6 +48,33 @@ import {
48
48
  type PyricAdminApp,
49
49
  } from '../app/index.js';
50
50
  import { assertAdminAppActive } from '../app/lifecycle.js';
51
+ import { defineDeferredMembers, deferredExport, type DeferredMembers } from 'pyric/app/internal';
52
+
53
+ // ─── Deferred surface ─────────────────────────────────────────────────────
54
+ //
55
+ // `firebase-admin/firestore` values and `Firestore` methods the sandbox does
56
+ // not model. Each fails with a `PyricDeferredApiError` naming it instead of
57
+ // reading as `undefined` at the call site.
58
+
59
+ const SUBPATH = 'pyric-admin/firestore';
60
+
61
+ export const AggregateField = deferredExport(SUBPATH, 'AggregateField');
62
+ export const Filter = deferredExport(SUBPATH, 'Filter');
63
+ export const GeoPoint = deferredExport(SUBPATH, 'GeoPoint');
64
+ export const GrpcStatus = deferredExport(SUBPATH, 'GrpcStatus');
65
+ export const initializeFirestore = deferredExport(SUBPATH, 'initializeFirestore');
66
+ export const setLogFunction = deferredExport(SUBPATH, 'setLogFunction');
67
+
68
+ const FIRESTORE_DEFERRED_MEMBERS: DeferredMembers = {
69
+ async: ['getAll', 'listCollections', 'recursiveDelete', 'terminate'],
70
+ sync: ['bulkWriter', 'bundle', 'settings'],
71
+ };
72
+
73
+ /** Define the deferred `Firestore` methods on a handle either arm built. */
74
+ function withDeferredMembers(db: SandboxFirestore): SandboxFirestore {
75
+ defineDeferredMembers(db, SUBPATH, 'Firestore', FIRESTORE_DEFERRED_MEMBERS);
76
+ return db;
77
+ }
51
78
 
52
79
  /** Narrow a `PyricAdminApp` to the {@link SandboxContext} the admin
53
80
  * firestore backend runs against. Sandbox apps expose their `Sandbox` —
@@ -89,12 +116,12 @@ export function getFirestore(
89
116
  target?: SandboxContext | PyricAdminApp,
90
117
  ): SandboxFirestore {
91
118
  if (target === undefined) {
92
- return baseGetAdminFirestore(adminAppToContext(getApp()));
119
+ return withDeferredMembers(baseGetAdminFirestore(adminAppToContext(getApp())));
93
120
  }
94
121
  if (typeof target === 'object' && target !== null && ADMIN_APP_TARGET in target) {
95
122
  const app = target as PyricAdminApp;
96
123
  assertAdminAppActive(app);
97
- return baseGetAdminFirestore(adminAppToContext(app));
124
+ return withDeferredMembers(baseGetAdminFirestore(adminAppToContext(app)));
98
125
  }
99
- return baseGetFirestore(target as SandboxContext);
126
+ return withDeferredMembers(baseGetFirestore(target as SandboxContext));
100
127
  }
@@ -0,0 +1,37 @@
1
+ /**
2
+ * `pyric-admin/functions`: deferred service handle for `firebase-admin/functions`.
3
+ */
4
+ import type { PyricAdminApp } from '../app/index.js';
5
+ import {
6
+ deferredAdminEntry,
7
+ guardDeferredServiceApp,
8
+ wireDeferredService,
9
+ } from '../deferred.js';
10
+
11
+ export { PyricDeferredApiError } from '../deferred.js';
12
+
13
+ export class Functions {
14
+ readonly #app: PyricAdminApp;
15
+
16
+ /** @internal */
17
+ constructor(...args: unknown[]) {
18
+ this.#app = guardDeferredServiceApp('functions', 'Functions', args);
19
+ }
20
+
21
+ get app(): PyricAdminApp {
22
+ return this.#app;
23
+ }
24
+
25
+ declare taskQueue: (...args: unknown[]) => never;
26
+ }
27
+
28
+ export const getFunctions: (app?: PyricAdminApp) => Functions = wireDeferredService(
29
+ Functions,
30
+ 'functions',
31
+ 'Functions',
32
+ {
33
+ sync: ['taskQueue'],
34
+ },
35
+ );
36
+
37
+ export const { TaskQueue } = deferredAdminEntry('functions');
@@ -0,0 +1,38 @@
1
+ /**
2
+ * `pyric-admin/installations`: deferred service handle for `firebase-admin/installations`.
3
+ */
4
+ import type { PyricAdminApp } from '../app/index.js';
5
+ import {
6
+ deferredAdminEntry,
7
+ guardDeferredServiceApp,
8
+ wireDeferredService,
9
+ } from '../deferred.js';
10
+
11
+ export { PyricDeferredApiError } from '../deferred.js';
12
+
13
+ export class Installations {
14
+ readonly #app: PyricAdminApp;
15
+
16
+ /** @internal */
17
+ constructor(...args: unknown[]) {
18
+ this.#app = guardDeferredServiceApp('installations', 'Installations', args);
19
+ }
20
+
21
+ get app(): PyricAdminApp {
22
+ return this.#app;
23
+ }
24
+
25
+ declare deleteInstallation: (...args: unknown[]) => Promise<never>;
26
+ }
27
+
28
+ export const getInstallations: (app?: PyricAdminApp) => Installations = wireDeferredService(
29
+ Installations,
30
+ 'installations',
31
+ 'Installations',
32
+ {
33
+ async: ['deleteInstallation'],
34
+ },
35
+ );
36
+
37
+ export const { FirebaseInstallationsError, InstallationsClientErrorCode } =
38
+ deferredAdminEntry('installations');
@@ -0,0 +1,38 @@
1
+ /**
2
+ * `pyric-admin/instance-id`: deferred service handle for `firebase-admin/instance-id`.
3
+ */
4
+ import type { PyricAdminApp } from '../app/index.js';
5
+ import {
6
+ deferredAdminEntry,
7
+ guardDeferredServiceApp,
8
+ wireDeferredService,
9
+ } from '../deferred.js';
10
+
11
+ export { PyricDeferredApiError } from '../deferred.js';
12
+
13
+ export class InstanceId {
14
+ readonly #app: PyricAdminApp;
15
+
16
+ /** @internal */
17
+ constructor(...args: unknown[]) {
18
+ this.#app = guardDeferredServiceApp('instance-id', 'InstanceId', args);
19
+ }
20
+
21
+ get app(): PyricAdminApp {
22
+ return this.#app;
23
+ }
24
+
25
+ declare deleteInstanceId: (...args: unknown[]) => Promise<never>;
26
+ }
27
+
28
+ export const getInstanceId: (app?: PyricAdminApp) => InstanceId = wireDeferredService(
29
+ InstanceId,
30
+ 'instance-id',
31
+ 'InstanceId',
32
+ {
33
+ async: ['deleteInstanceId'],
34
+ },
35
+ );
36
+
37
+ export const { FirebaseInstanceIdError, InstanceIdClientErrorCode } =
38
+ deferredAdminEntry('instance-id');
@@ -0,0 +1,51 @@
1
+ /**
2
+ * `pyric-admin/machine-learning`: deferred service handle for `firebase-admin/machine-learning`.
3
+ */
4
+ import type { PyricAdminApp } from '../app/index.js';
5
+ import {
6
+ deferredAdminEntry,
7
+ guardDeferredServiceApp,
8
+ wireDeferredService,
9
+ } from '../deferred.js';
10
+
11
+ export { PyricDeferredApiError } from '../deferred.js';
12
+
13
+ export class MachineLearning {
14
+ readonly #app: PyricAdminApp;
15
+
16
+ /** @internal */
17
+ constructor(...args: unknown[]) {
18
+ this.#app = guardDeferredServiceApp('machine-learning', 'MachineLearning', args);
19
+ }
20
+
21
+ get app(): PyricAdminApp {
22
+ return this.#app;
23
+ }
24
+
25
+ declare createModel: (...args: unknown[]) => Promise<never>;
26
+ declare deleteModel: (...args: unknown[]) => Promise<never>;
27
+ declare getModel: (...args: unknown[]) => Promise<never>;
28
+ declare listModels: (...args: unknown[]) => Promise<never>;
29
+ declare publishModel: (...args: unknown[]) => Promise<never>;
30
+ declare unpublishModel: (...args: unknown[]) => Promise<never>;
31
+ declare updateModel: (...args: unknown[]) => Promise<never>;
32
+ }
33
+
34
+ export const getMachineLearning: (app?: PyricAdminApp) => MachineLearning = wireDeferredService(
35
+ MachineLearning,
36
+ 'machine-learning',
37
+ 'MachineLearning',
38
+ {
39
+ async: [
40
+ 'createModel',
41
+ 'deleteModel',
42
+ 'getModel',
43
+ 'listModels',
44
+ 'publishModel',
45
+ 'unpublishModel',
46
+ 'updateModel',
47
+ ],
48
+ },
49
+ );
50
+
51
+ export const { Model } = deferredAdminEntry('machine-learning');
@@ -33,7 +33,6 @@ import {
33
33
  getMessagingBroker,
34
34
  BrokerSendError,
35
35
  type BrokerMessage,
36
- type MessagingBroker,
37
36
  type TopicManagementOutcome,
38
37
  } from 'pyric/messaging/internal';
39
38
 
@@ -137,7 +136,6 @@ function invalidArgument(message: string): Error & { readonly code: string } {
137
136
 
138
137
  async function dispatchSend(
139
138
  sandbox: Sandbox,
140
- broker: MessagingBroker,
141
139
  message: BrokerMessage,
142
140
  validateOnly: boolean,
143
141
  ): Promise<string> {
@@ -149,12 +147,11 @@ async function dispatchSend(
149
147
  })) as { name: string };
150
148
  return res.name;
151
149
  }
152
- return broker.send(message, { validateOnly }).name;
150
+ return getMessagingBroker(sandbox).send(message, { validateOnly }).name;
153
151
  }
154
152
 
155
153
  async function dispatchTopicOp(
156
154
  sandbox: Sandbox,
157
- broker: MessagingBroker,
158
155
  action: 'subscribe' | 'unsubscribe',
159
156
  tokens: string[],
160
157
  topic: string,
@@ -166,6 +163,7 @@ async function dispatchTopicOp(
166
163
  topic,
167
164
  })) as TopicManagementOutcome;
168
165
  }
166
+ const broker = getMessagingBroker(sandbox);
169
167
  return action === 'subscribe'
170
168
  ? broker.subscribeToTopic(tokens, topic)
171
169
  : broker.unsubscribeFromTopic(tokens, topic);
@@ -178,12 +176,10 @@ async function dispatchTopicOp(
178
176
  * the broker.
179
177
  */
180
178
  export class Messaging {
181
- private readonly broker: MessagingBroker;
182
179
  private readonly boundApp: PyricAdminApp;
183
180
 
184
181
  constructor(app: SandboxAdminApp) {
185
182
  this.boundApp = app;
186
- this.broker = getMessagingBroker(app.sandbox);
187
183
  }
188
184
 
189
185
  /** The app this `Messaging` instance is bound to (upstream `get app(): App`). */
@@ -202,7 +198,6 @@ export class Messaging {
202
198
  try {
203
199
  return await dispatchSend(
204
200
  this.boundApp.sandbox,
205
- this.broker,
206
201
  message as BrokerMessage,
207
202
  dryRun === true,
208
203
  );
@@ -227,7 +222,6 @@ export class Messaging {
227
222
  try {
228
223
  const name = await dispatchSend(
229
224
  this.boundApp.sandbox,
230
- this.broker,
231
225
  message as BrokerMessage,
232
226
  dryRun === true,
233
227
  );
@@ -288,7 +282,6 @@ export class Messaging {
288
282
  try {
289
283
  outcome = await dispatchTopicOp(
290
284
  this.boundApp.sandbox,
291
- this.broker,
292
285
  action,
293
286
  tokens,
294
287
  topic,
@@ -341,6 +334,7 @@ function resolveApp(app?: PyricAdminApp): PyricAdminApp {
341
334
  [ADMIN_APP_TARGET]: 'sandbox',
342
335
  sandbox: initializeSandbox(),
343
336
  name: '[pyric-messaging-climb]',
337
+ options: {},
344
338
  };
345
339
  return climbDefaultApp;
346
340
  }
@@ -0,0 +1,36 @@
1
+ /**
2
+ * `pyric-admin/phone-number-verification`: deferred service handle for `firebase-admin/phone-number-verification`.
3
+ */
4
+ import type { PyricAdminApp } from '../app/index.js';
5
+ import { guardDeferredServiceApp, wireDeferredService } from '../deferred.js';
6
+
7
+ export { PyricDeferredApiError } from '../deferred.js';
8
+
9
+ export class PhoneNumberVerification {
10
+ readonly #app: PyricAdminApp;
11
+
12
+ /** @internal */
13
+ constructor(...args: unknown[]) {
14
+ this.#app = guardDeferredServiceApp(
15
+ 'phone-number-verification',
16
+ 'PhoneNumberVerification',
17
+ args,
18
+ );
19
+ }
20
+
21
+ get app(): PyricAdminApp {
22
+ return this.#app;
23
+ }
24
+
25
+ declare verifyToken: (...args: unknown[]) => Promise<never>;
26
+ }
27
+
28
+ export const getPhoneNumberVerification: (app?: PyricAdminApp) => PhoneNumberVerification =
29
+ wireDeferredService(
30
+ PhoneNumberVerification,
31
+ 'phone-number-verification',
32
+ 'PhoneNumberVerification',
33
+ {
34
+ async: ['verifyToken'],
35
+ },
36
+ );
@@ -0,0 +1,55 @@
1
+ /**
2
+ * `pyric-admin/project-management`: deferred service handle for `firebase-admin/project-management`.
3
+ */
4
+ import type { PyricAdminApp } from '../app/index.js';
5
+ import {
6
+ deferredAdminEntry,
7
+ guardDeferredServiceApp,
8
+ wireDeferredService,
9
+ } from '../deferred.js';
10
+
11
+ export { PyricDeferredApiError } from '../deferred.js';
12
+
13
+ export class ProjectManagement {
14
+ readonly #app: PyricAdminApp;
15
+
16
+ /** @internal */
17
+ constructor(...args: unknown[]) {
18
+ this.#app = guardDeferredServiceApp('project-management', 'ProjectManagement', args);
19
+ }
20
+
21
+ get app(): PyricAdminApp {
22
+ return this.#app;
23
+ }
24
+
25
+ declare androidApp: (...args: unknown[]) => never;
26
+ declare iosApp: (...args: unknown[]) => never;
27
+ declare shaCertificate: (...args: unknown[]) => never;
28
+ declare createAndroidApp: (...args: unknown[]) => Promise<never>;
29
+ declare createIosApp: (...args: unknown[]) => Promise<never>;
30
+ declare listAndroidApps: (...args: unknown[]) => Promise<never>;
31
+ declare listAppMetadata: (...args: unknown[]) => Promise<never>;
32
+ declare listIosApps: (...args: unknown[]) => Promise<never>;
33
+ declare setDisplayName: (...args: unknown[]) => Promise<never>;
34
+ }
35
+
36
+ export const getProjectManagement: (app?: PyricAdminApp) => ProjectManagement =
37
+ wireDeferredService(ProjectManagement, 'project-management', 'ProjectManagement', {
38
+ sync: ['androidApp', 'iosApp', 'shaCertificate'],
39
+ async: [
40
+ 'createAndroidApp',
41
+ 'createIosApp',
42
+ 'listAndroidApps',
43
+ 'listAppMetadata',
44
+ 'listIosApps',
45
+ 'setDisplayName',
46
+ ],
47
+ });
48
+
49
+ export const {
50
+ AndroidApp,
51
+ AppPlatform,
52
+ FirebaseProjectManagementError,
53
+ IosApp,
54
+ ShaCertificate,
55
+ } = deferredAdminEntry('project-management');
@@ -0,0 +1,58 @@
1
+ /**
2
+ * `pyric-admin/remote-config`: deferred service handle for `firebase-admin/remote-config`.
3
+ */
4
+ import type { PyricAdminApp } from '../app/index.js';
5
+ import {
6
+ deferredAdminEntry,
7
+ guardDeferredServiceApp,
8
+ wireDeferredService,
9
+ } from '../deferred.js';
10
+
11
+ export { PyricDeferredApiError } from '../deferred.js';
12
+
13
+ export class RemoteConfig {
14
+ readonly #app: PyricAdminApp;
15
+
16
+ /** @internal */
17
+ constructor(...args: unknown[]) {
18
+ this.#app = guardDeferredServiceApp('remote-config', 'RemoteConfig', args);
19
+ }
20
+
21
+ get app(): PyricAdminApp {
22
+ return this.#app;
23
+ }
24
+
25
+ declare createTemplateFromJSON: (...args: unknown[]) => never;
26
+ declare initServerTemplate: (...args: unknown[]) => never;
27
+ declare getServerTemplate: (...args: unknown[]) => Promise<never>;
28
+ declare getTemplate: (...args: unknown[]) => Promise<never>;
29
+ declare getTemplateAtVersion: (...args: unknown[]) => Promise<never>;
30
+ declare listVersions: (...args: unknown[]) => Promise<never>;
31
+ declare publishTemplate: (...args: unknown[]) => Promise<never>;
32
+ declare rollback: (...args: unknown[]) => Promise<never>;
33
+ declare validateTemplate: (...args: unknown[]) => Promise<never>;
34
+ }
35
+
36
+ export const getRemoteConfig: (app?: PyricAdminApp) => RemoteConfig = wireDeferredService(
37
+ RemoteConfig,
38
+ 'remote-config',
39
+ 'RemoteConfig',
40
+ {
41
+ sync: ['createTemplateFromJSON', 'initServerTemplate'],
42
+ async: [
43
+ 'getServerTemplate',
44
+ 'getTemplate',
45
+ 'getTemplateAtVersion',
46
+ 'listVersions',
47
+ 'publishTemplate',
48
+ 'rollback',
49
+ 'validateTemplate',
50
+ ],
51
+ },
52
+ );
53
+
54
+ export const {
55
+ CustomSignalOperator,
56
+ PercentConditionOperator,
57
+ RemoteConfigFetchResponse,
58
+ } = deferredAdminEntry('remote-config');
@@ -0,0 +1,59 @@
1
+ /**
2
+ * `pyric-admin/security-rules`: deferred service handle for `firebase-admin/security-rules`.
3
+ */
4
+ import type { PyricAdminApp } from '../app/index.js';
5
+ import {
6
+ deferredAdminEntry,
7
+ guardDeferredServiceApp,
8
+ wireDeferredService,
9
+ } from '../deferred.js';
10
+
11
+ export { PyricDeferredApiError } from '../deferred.js';
12
+
13
+ export class SecurityRules {
14
+ readonly #app: PyricAdminApp;
15
+
16
+ /** @internal */
17
+ constructor(...args: unknown[]) {
18
+ this.#app = guardDeferredServiceApp('security-rules', 'SecurityRules', args);
19
+ }
20
+
21
+ get app(): PyricAdminApp {
22
+ return this.#app;
23
+ }
24
+
25
+ declare createRulesFileFromSource: (...args: unknown[]) => never;
26
+ declare createRuleset: (...args: unknown[]) => Promise<never>;
27
+ declare deleteRuleset: (...args: unknown[]) => Promise<never>;
28
+ declare getFirestoreRuleset: (...args: unknown[]) => Promise<never>;
29
+ declare getRuleset: (...args: unknown[]) => Promise<never>;
30
+ declare getStorageRuleset: (...args: unknown[]) => Promise<never>;
31
+ declare listRulesetMetadata: (...args: unknown[]) => Promise<never>;
32
+ declare releaseFirestoreRuleset: (...args: unknown[]) => Promise<never>;
33
+ declare releaseFirestoreRulesetFromSource: (...args: unknown[]) => Promise<never>;
34
+ declare releaseStorageRuleset: (...args: unknown[]) => Promise<never>;
35
+ declare releaseStorageRulesetFromSource: (...args: unknown[]) => Promise<never>;
36
+ }
37
+
38
+ export const getSecurityRules: (app?: PyricAdminApp) => SecurityRules = wireDeferredService(
39
+ SecurityRules,
40
+ 'security-rules',
41
+ 'SecurityRules',
42
+ {
43
+ sync: ['createRulesFileFromSource'],
44
+ async: [
45
+ 'createRuleset',
46
+ 'deleteRuleset',
47
+ 'getRuleset',
48
+ 'getFirestoreRuleset',
49
+ 'getStorageRuleset',
50
+ 'listRulesetMetadata',
51
+ 'releaseFirestoreRuleset',
52
+ 'releaseFirestoreRulesetFromSource',
53
+ 'releaseStorageRuleset',
54
+ 'releaseStorageRulesetFromSource',
55
+ ],
56
+ },
57
+ );
58
+
59
+ export const { Ruleset, RulesetMetadataList } = deferredAdminEntry('security-rules');
@@ -0,0 +1,67 @@
1
+ /**
2
+ * The `@google-cloud/storage` `Bucket` and `File` methods the sandbox does
3
+ * not model. Each one is defined on the sandbox handles as a deferred member
4
+ * that throws, or rejects for a method whose upstream form returns a
5
+ * promise, a `PyricDeferredApiError` naming the method, instead of reading as
6
+ * `undefined` at the call site.
7
+ *
8
+ * Properties and the inherited `EventEmitter` methods are not stubbed; they
9
+ * are listed with their reason in the `pyric-admin` surface allowlist.
10
+ */
11
+ import type { DeferredMembers } from 'pyric/app/internal';
12
+
13
+ export const BUCKET_DEFERRED_MEMBERS: DeferredMembers = {
14
+ async: [
15
+ 'addLifecycleRule',
16
+ 'combine',
17
+ 'create',
18
+ 'createChannel',
19
+ 'createNotification',
20
+ 'delete',
21
+ 'deleteLabels',
22
+ 'disableRequesterPays',
23
+ 'enableLogging',
24
+ 'enableRequesterPays',
25
+ 'exists',
26
+ 'get',
27
+ 'getLabels',
28
+ 'getMetadata',
29
+ 'getNotifications',
30
+ 'getSignedUrl',
31
+ 'lock',
32
+ 'makePrivate',
33
+ 'makePublic',
34
+ 'removeRetentionPeriod',
35
+ 'request',
36
+ 'restore',
37
+ 'setCorsConfiguration',
38
+ 'setLabels',
39
+ 'setMetadata',
40
+ 'setRetentionPeriod',
41
+ 'setStorageClass',
42
+ 'upload',
43
+ ],
44
+ sync: ['getFilesStream', 'getId', 'getRequestInterceptors', 'notification', 'requestStream', 'setUserProject'],
45
+ };
46
+
47
+ export const FILE_DEFERRED_MEMBERS: DeferredMembers = {
48
+ async: [
49
+ 'copy',
50
+ 'create',
51
+ 'generateSignedPostPolicyV2',
52
+ 'generateSignedPostPolicyV4',
53
+ 'get',
54
+ 'getExpirationDate',
55
+ 'isPublic',
56
+ 'makePrivate',
57
+ 'makePublic',
58
+ 'move',
59
+ 'moveFileAtomic',
60
+ 'rename',
61
+ 'request',
62
+ 'restore',
63
+ 'rotateEncryptionKey',
64
+ 'setStorageClass',
65
+ ],
66
+ sync: ['getRequestInterceptors', 'publicUrl', 'requestStream', 'setEncryptionKey', 'setUserProject'],
67
+ };
@@ -0,0 +1,40 @@
1
+ /**
2
+ * `Bucket.deleteFiles`, as `@google-cloud/storage` runs it: list the files the
3
+ * query names across every page, up to `maxResults`, and delete them ten at a
4
+ * time.
5
+ *
6
+ * Without `force`, the first failed delete rejects the call and no more are
7
+ * started. With `force`, every file is tried, and the call rejects with the
8
+ * array of errors when any failed, as the library's callback receives them.
9
+ */
10
+ import { everyListedName, type DeleteFilesOptions } from './file-query.js';
11
+
12
+ /** How many deletes `@google-cloud/storage` runs at once. */
13
+ const PARALLEL_DELETES = 10;
14
+
15
+ /** Delete each object of `names` that `query` lists, with `remove`. */
16
+ export async function deleteListedFiles(
17
+ names: readonly string[],
18
+ query: DeleteFilesOptions,
19
+ remove: (name: string) => Promise<void>,
20
+ ): Promise<void> {
21
+ const queue = everyListedName(names, query);
22
+ const errors: unknown[] = [];
23
+ const force = query.force === true;
24
+ const worker = async (): Promise<void> => {
25
+ for (;;) {
26
+ const stopped = errors.length > 0 && !force;
27
+ const name = queue.shift();
28
+ if (stopped || name === undefined) return;
29
+ try {
30
+ await remove(name);
31
+ } catch (error) {
32
+ errors.push(error);
33
+ }
34
+ }
35
+ };
36
+ await Promise.all(Array.from({ length: PARALLEL_DELETES }, worker));
37
+ if (errors.length === 0) return;
38
+ if (!force) throw errors[0];
39
+ throw errors;
40
+ }