pyric-admin 0.1.0-alpha.24 → 0.1.0-alpha.26

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 (128) hide show
  1. package/README.md +1 -1
  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 +13 -1
  11. package/dist/app-check/index.d.ts.map +1 -1
  12. package/dist/app-check/index.js +14 -9
  13. package/dist/app-check/index.js.map +1 -1
  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 +23 -1
  18. package/dist/data-connect/index.d.ts.map +1 -1
  19. package/dist/data-connect/index.js +44 -7
  20. package/dist/data-connect/index.js.map +1 -1
  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 +37 -13
  26. package/dist/deferred.d.ts.map +1 -1
  27. package/dist/deferred.js +57 -15
  28. package/dist/deferred.js.map +1 -1
  29. package/dist/eventarc/index.d.ts +13 -1
  30. package/dist/eventarc/index.d.ts.map +1 -1
  31. package/dist/eventarc/index.js +15 -9
  32. package/dist/eventarc/index.js.map +1 -1
  33. package/dist/extensions/index.d.ts +13 -1
  34. package/dist/extensions/index.d.ts.map +1 -1
  35. package/dist/extensions/index.js +15 -9
  36. package/dist/extensions/index.js.map +1 -1
  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 +13 -1
  42. package/dist/functions/index.d.ts.map +1 -1
  43. package/dist/functions/index.js +15 -9
  44. package/dist/functions/index.js.map +1 -1
  45. package/dist/installations/index.d.ts +13 -1
  46. package/dist/installations/index.d.ts.map +1 -1
  47. package/dist/installations/index.js +15 -9
  48. package/dist/installations/index.js.map +1 -1
  49. package/dist/instance-id/index.d.ts +13 -1
  50. package/dist/instance-id/index.d.ts.map +1 -1
  51. package/dist/instance-id/index.js +15 -9
  52. package/dist/instance-id/index.js.map +1 -1
  53. package/dist/machine-learning/index.d.ts +19 -1
  54. package/dist/machine-learning/index.d.ts.map +1 -1
  55. package/dist/machine-learning/index.js +23 -9
  56. package/dist/machine-learning/index.js.map +1 -1
  57. package/dist/messaging/index.d.ts.map +1 -1
  58. package/dist/messaging/index.js +1 -0
  59. package/dist/messaging/index.js.map +1 -1
  60. package/dist/phone-number-verification/index.d.ts +12 -1
  61. package/dist/phone-number-verification/index.d.ts.map +1 -1
  62. package/dist/phone-number-verification/index.js +14 -9
  63. package/dist/phone-number-verification/index.js.map +1 -1
  64. package/dist/project-management/index.d.ts +21 -1
  65. package/dist/project-management/index.d.ts.map +1 -1
  66. package/dist/project-management/index.js +23 -9
  67. package/dist/project-management/index.js.map +1 -1
  68. package/dist/remote-config/index.d.ts +21 -1
  69. package/dist/remote-config/index.d.ts.map +1 -1
  70. package/dist/remote-config/index.js +24 -9
  71. package/dist/remote-config/index.js.map +1 -1
  72. package/dist/security-rules/index.d.ts +23 -1
  73. package/dist/security-rules/index.d.ts.map +1 -1
  74. package/dist/security-rules/index.js +27 -9
  75. package/dist/security-rules/index.js.map +1 -1
  76. package/dist/storage/deferred-members.d.ts +14 -0
  77. package/dist/storage/deferred-members.d.ts.map +1 -0
  78. package/dist/storage/deferred-members.js +55 -0
  79. package/dist/storage/deferred-members.js.map +1 -0
  80. package/dist/storage/delete-files.d.ts +13 -0
  81. package/dist/storage/delete-files.d.ts.map +1 -0
  82. package/dist/storage/delete-files.js +39 -0
  83. package/dist/storage/delete-files.js.map +1 -0
  84. package/dist/storage/file-query.d.ts +52 -0
  85. package/dist/storage/file-query.d.ts.map +1 -0
  86. package/dist/storage/file-query.js +94 -0
  87. package/dist/storage/file-query.js.map +1 -0
  88. package/dist/storage/get-files.d.ts +15 -0
  89. package/dist/storage/get-files.d.ts.map +1 -0
  90. package/dist/storage/get-files.js +33 -0
  91. package/dist/storage/get-files.js.map +1 -0
  92. package/dist/storage/index.d.ts +77 -13
  93. package/dist/storage/index.d.ts.map +1 -1
  94. package/dist/storage/index.js +359 -160
  95. package/dist/storage/index.js.map +1 -1
  96. package/dist/storage/remote-names.d.ts +19 -0
  97. package/dist/storage/remote-names.d.ts.map +1 -0
  98. package/dist/storage/remote-names.js +26 -0
  99. package/dist/storage/remote-names.js.map +1 -0
  100. package/package.json +2 -2
  101. package/src/admin.ts +58 -8
  102. package/src/app/index.ts +71 -19
  103. package/src/app-check/index.ts +27 -9
  104. package/src/auth/auth.test.ts +27 -0
  105. package/src/auth/index.ts +8 -0
  106. package/src/data-connect/index.ts +70 -9
  107. package/src/database/database.test.ts +1 -0
  108. package/src/database/index.ts +182 -108
  109. package/src/deferred.ts +78 -15
  110. package/src/eventarc/index.ts +32 -9
  111. package/src/extensions/index.ts +32 -9
  112. package/src/firestore/index.ts +30 -3
  113. package/src/functions/index.ts +32 -9
  114. package/src/installations/index.ts +33 -10
  115. package/src/instance-id/index.ts +33 -9
  116. package/src/machine-learning/index.ts +46 -9
  117. package/src/messaging/index.ts +1 -0
  118. package/src/phone-number-verification/index.ts +31 -9
  119. package/src/project-management/index.ts +48 -8
  120. package/src/remote-config/index.ts +51 -8
  121. package/src/security-rules/index.ts +54 -9
  122. package/src/storage/deferred-members.ts +67 -0
  123. package/src/storage/delete-files.ts +40 -0
  124. package/src/storage/file-query.ts +135 -0
  125. package/src/storage/get-files.ts +40 -0
  126. package/src/storage/index.ts +484 -180
  127. package/src/storage/remote-names.ts +34 -0
  128. package/src/storage/storage.test.ts +78 -5
@@ -1,14 +1,37 @@
1
1
  /**
2
- * `pyric-admin/extensions`: a deferred entry for `firebase-admin/extensions`.
3
- *
4
- * The sandbox does not model Extensions. Every value `firebase-admin/extensions`
5
- * exports is present so imports link; using one throws `PyricDeferredApiError`.
6
- * See `../deferred.ts`.
2
+ * `pyric-admin/extensions`: deferred service handle for `firebase-admin/extensions`.
7
3
  */
8
- import { deferredAdminEntry } from '../deferred.js';
4
+ import type { PyricAdminApp } from '../app/index.js';
5
+ import {
6
+ deferredAdminEntry,
7
+ guardDeferredServiceApp,
8
+ wireDeferredService,
9
+ } from '../deferred.js';
9
10
 
10
11
  export { PyricDeferredApiError } from '../deferred.js';
11
12
 
12
- export const {
13
- Extensions, Runtime, getExtensions,
14
- } = deferredAdminEntry('extensions');
13
+ export class Extensions {
14
+ readonly #app: PyricAdminApp;
15
+
16
+ /** @internal */
17
+ constructor(...args: unknown[]) {
18
+ this.#app = guardDeferredServiceApp('extensions', 'Extensions', args);
19
+ }
20
+
21
+ get app(): PyricAdminApp {
22
+ return this.#app;
23
+ }
24
+
25
+ declare runtime: (...args: unknown[]) => never;
26
+ }
27
+
28
+ export const getExtensions: (app?: PyricAdminApp) => Extensions = wireDeferredService(
29
+ Extensions,
30
+ 'extensions',
31
+ 'Extensions',
32
+ {
33
+ sync: ['runtime'],
34
+ },
35
+ );
36
+
37
+ export const { Runtime } = deferredAdminEntry('extensions');
@@ -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
  }
@@ -1,14 +1,37 @@
1
1
  /**
2
- * `pyric-admin/functions`: a deferred entry for `firebase-admin/functions`.
3
- *
4
- * The sandbox does not model Cloud Functions task queues. Every value `firebase-admin/functions`
5
- * exports is present so imports link; using one throws `PyricDeferredApiError`.
6
- * See `../deferred.ts`.
2
+ * `pyric-admin/functions`: deferred service handle for `firebase-admin/functions`.
7
3
  */
8
- import { deferredAdminEntry } from '../deferred.js';
4
+ import type { PyricAdminApp } from '../app/index.js';
5
+ import {
6
+ deferredAdminEntry,
7
+ guardDeferredServiceApp,
8
+ wireDeferredService,
9
+ } from '../deferred.js';
9
10
 
10
11
  export { PyricDeferredApiError } from '../deferred.js';
11
12
 
12
- export const {
13
- Functions, TaskQueue, getFunctions,
14
- } = deferredAdminEntry('functions');
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');
@@ -1,15 +1,38 @@
1
1
  /**
2
- * `pyric-admin/installations`: a deferred entry for `firebase-admin/installations`.
3
- *
4
- * The sandbox does not model Firebase Installations. Every value `firebase-admin/installations`
5
- * exports is present so imports link; using one throws `PyricDeferredApiError`.
6
- * See `../deferred.ts`.
2
+ * `pyric-admin/installations`: deferred service handle for `firebase-admin/installations`.
7
3
  */
8
- import { deferredAdminEntry } from '../deferred.js';
4
+ import type { PyricAdminApp } from '../app/index.js';
5
+ import {
6
+ deferredAdminEntry,
7
+ guardDeferredServiceApp,
8
+ wireDeferredService,
9
+ } from '../deferred.js';
9
10
 
10
11
  export { PyricDeferredApiError } from '../deferred.js';
11
12
 
12
- export const {
13
- FirebaseInstallationsError, Installations, InstallationsClientErrorCode,
14
- getInstallations,
15
- } = deferredAdminEntry('installations');
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');
@@ -1,14 +1,38 @@
1
1
  /**
2
- * `pyric-admin/instance-id`: a deferred entry for `firebase-admin/instance-id`.
3
- *
4
- * The sandbox does not model Instance ID. Every value `firebase-admin/instance-id`
5
- * exports is present so imports link; using one throws `PyricDeferredApiError`.
6
- * See `../deferred.ts`.
2
+ * `pyric-admin/instance-id`: deferred service handle for `firebase-admin/instance-id`.
7
3
  */
8
- import { deferredAdminEntry } from '../deferred.js';
4
+ import type { PyricAdminApp } from '../app/index.js';
5
+ import {
6
+ deferredAdminEntry,
7
+ guardDeferredServiceApp,
8
+ wireDeferredService,
9
+ } from '../deferred.js';
9
10
 
10
11
  export { PyricDeferredApiError } from '../deferred.js';
11
12
 
12
- export const {
13
- FirebaseInstanceIdError, InstanceId, InstanceIdClientErrorCode, getInstanceId,
14
- } = deferredAdminEntry('instance-id');
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');
@@ -1,14 +1,51 @@
1
1
  /**
2
- * `pyric-admin/machine-learning`: a deferred entry for `firebase-admin/machine-learning`.
3
- *
4
- * The sandbox does not model Firebase ML. Every value `firebase-admin/machine-learning`
5
- * exports is present so imports link; using one throws `PyricDeferredApiError`.
6
- * See `../deferred.ts`.
2
+ * `pyric-admin/machine-learning`: deferred service handle for `firebase-admin/machine-learning`.
7
3
  */
8
- import { deferredAdminEntry } from '../deferred.js';
4
+ import type { PyricAdminApp } from '../app/index.js';
5
+ import {
6
+ deferredAdminEntry,
7
+ guardDeferredServiceApp,
8
+ wireDeferredService,
9
+ } from '../deferred.js';
9
10
 
10
11
  export { PyricDeferredApiError } from '../deferred.js';
11
12
 
12
- export const {
13
- MachineLearning, Model, getMachineLearning,
14
- } = deferredAdminEntry('machine-learning');
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');
@@ -334,6 +334,7 @@ function resolveApp(app?: PyricAdminApp): PyricAdminApp {
334
334
  [ADMIN_APP_TARGET]: 'sandbox',
335
335
  sandbox: initializeSandbox(),
336
336
  name: '[pyric-messaging-climb]',
337
+ options: {},
337
338
  };
338
339
  return climbDefaultApp;
339
340
  }
@@ -1,14 +1,36 @@
1
1
  /**
2
- * `pyric-admin/phone-number-verification`: a deferred entry for `firebase-admin/phone-number-verification`.
3
- *
4
- * The sandbox does not model Phone Number Verification. Every value `firebase-admin/phone-number-verification`
5
- * exports is present so imports link; using one throws `PyricDeferredApiError`.
6
- * See `../deferred.ts`.
2
+ * `pyric-admin/phone-number-verification`: deferred service handle for `firebase-admin/phone-number-verification`.
7
3
  */
8
- import { deferredAdminEntry } from '../deferred.js';
4
+ import type { PyricAdminApp } from '../app/index.js';
5
+ import { guardDeferredServiceApp, wireDeferredService } from '../deferred.js';
9
6
 
10
7
  export { PyricDeferredApiError } from '../deferred.js';
11
8
 
12
- export const {
13
- PhoneNumberVerification, getPhoneNumberVerification,
14
- } = deferredAdminEntry('phone-number-verification');
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
+ );
@@ -1,15 +1,55 @@
1
1
  /**
2
- * `pyric-admin/project-management`: a deferred entry for `firebase-admin/project-management`.
3
- *
4
- * The sandbox does not model Project Management. Every value `firebase-admin/project-management`
5
- * exports is present so imports link; using one throws `PyricDeferredApiError`.
6
- * See `../deferred.ts`.
2
+ * `pyric-admin/project-management`: deferred service handle for `firebase-admin/project-management`.
7
3
  */
8
- import { deferredAdminEntry } from '../deferred.js';
4
+ import type { PyricAdminApp } from '../app/index.js';
5
+ import {
6
+ deferredAdminEntry,
7
+ guardDeferredServiceApp,
8
+ wireDeferredService,
9
+ } from '../deferred.js';
9
10
 
10
11
  export { PyricDeferredApiError } from '../deferred.js';
11
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
+
12
49
  export const {
13
- AndroidApp, AppPlatform, FirebaseProjectManagementError, IosApp, ProjectManagement,
14
- ShaCertificate, getProjectManagement,
50
+ AndroidApp,
51
+ AppPlatform,
52
+ FirebaseProjectManagementError,
53
+ IosApp,
54
+ ShaCertificate,
15
55
  } = deferredAdminEntry('project-management');
@@ -1,15 +1,58 @@
1
1
  /**
2
- * `pyric-admin/remote-config`: a deferred entry for `firebase-admin/remote-config`.
3
- *
4
- * The sandbox does not model Remote Config. Every value `firebase-admin/remote-config`
5
- * exports is present so imports link; using one throws `PyricDeferredApiError`.
6
- * See `../deferred.ts`.
2
+ * `pyric-admin/remote-config`: deferred service handle for `firebase-admin/remote-config`.
7
3
  */
8
- import { deferredAdminEntry } from '../deferred.js';
4
+ import type { PyricAdminApp } from '../app/index.js';
5
+ import {
6
+ deferredAdminEntry,
7
+ guardDeferredServiceApp,
8
+ wireDeferredService,
9
+ } from '../deferred.js';
9
10
 
10
11
  export { PyricDeferredApiError } from '../deferred.js';
11
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
+
12
54
  export const {
13
- CustomSignalOperator, PercentConditionOperator, RemoteConfig,
14
- RemoteConfigFetchResponse, getRemoteConfig,
55
+ CustomSignalOperator,
56
+ PercentConditionOperator,
57
+ RemoteConfigFetchResponse,
15
58
  } = deferredAdminEntry('remote-config');
@@ -1,14 +1,59 @@
1
1
  /**
2
- * `pyric-admin/security-rules`: a deferred entry for `firebase-admin/security-rules`.
3
- *
4
- * The sandbox does not model Security Rules management. Every value `firebase-admin/security-rules`
5
- * exports is present so imports link; using one throws `PyricDeferredApiError`.
6
- * See `../deferred.ts`.
2
+ * `pyric-admin/security-rules`: deferred service handle for `firebase-admin/security-rules`.
7
3
  */
8
- import { deferredAdminEntry } from '../deferred.js';
4
+ import type { PyricAdminApp } from '../app/index.js';
5
+ import {
6
+ deferredAdminEntry,
7
+ guardDeferredServiceApp,
8
+ wireDeferredService,
9
+ } from '../deferred.js';
9
10
 
10
11
  export { PyricDeferredApiError } from '../deferred.js';
11
12
 
12
- export const {
13
- Ruleset, RulesetMetadataList, SecurityRules, getSecurityRules,
14
- } = deferredAdminEntry('security-rules');
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
+ }