primitive-admin 1.3.0-alpha.1 → 1.3.0-alpha.3

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 (116) hide show
  1. package/README.md +46 -22
  2. package/dist/bin/primitive.js +11 -4
  3. package/dist/bin/primitive.js.map +1 -1
  4. package/dist/src/commands/admins.js +91 -0
  5. package/dist/src/commands/admins.js.map +1 -1
  6. package/dist/src/commands/apps.d.ts +3 -6
  7. package/dist/src/commands/apps.js +7 -22
  8. package/dist/src/commands/apps.js.map +1 -1
  9. package/dist/src/commands/auth-passkeys.d.ts +7 -0
  10. package/dist/src/commands/auth-passkeys.js +99 -0
  11. package/dist/src/commands/auth-passkeys.js.map +1 -0
  12. package/dist/src/commands/auth-sessions.js +7 -28
  13. package/dist/src/commands/auth-sessions.js.map +1 -1
  14. package/dist/src/commands/auth.js +1 -1
  15. package/dist/src/commands/auth.js.map +1 -1
  16. package/dist/src/commands/blob-buckets.d.ts +8 -0
  17. package/dist/src/commands/blob-buckets.js +23 -8
  18. package/dist/src/commands/blob-buckets.js.map +1 -1
  19. package/dist/src/commands/db3.js +6 -0
  20. package/dist/src/commands/db3.js.map +1 -1
  21. package/dist/src/commands/documents.js +3 -0
  22. package/dist/src/commands/documents.js.map +1 -1
  23. package/dist/src/commands/functions.js +13 -4
  24. package/dist/src/commands/functions.js.map +1 -1
  25. package/dist/src/commands/init.js +11 -0
  26. package/dist/src/commands/init.js.map +1 -1
  27. package/dist/src/commands/rule-sets.d.ts +1 -1
  28. package/dist/src/commands/rule-sets.js +0 -1
  29. package/dist/src/commands/rule-sets.js.map +1 -1
  30. package/dist/src/commands/sync-app-settings.d.ts +88 -1
  31. package/dist/src/commands/sync-app-settings.js +224 -8
  32. package/dist/src/commands/sync-app-settings.js.map +1 -1
  33. package/dist/src/commands/sync.d.ts +27 -26
  34. package/dist/src/commands/sync.js +249 -116
  35. package/dist/src/commands/sync.js.map +1 -1
  36. package/dist/src/commands/usage.d.ts +12 -2
  37. package/dist/src/commands/usage.js +115 -5
  38. package/dist/src/commands/usage.js.map +1 -1
  39. package/dist/src/lib/admin-login-tables.d.ts +31 -0
  40. package/dist/src/lib/admin-login-tables.js +75 -0
  41. package/dist/src/lib/admin-login-tables.js.map +1 -0
  42. package/dist/src/lib/api-client.d.ts +156 -5
  43. package/dist/src/lib/api-client.js +90 -9
  44. package/dist/src/lib/api-client.js.map +1 -1
  45. package/dist/src/lib/app-settings-descriptor.d.ts +29 -2
  46. package/dist/src/lib/app-settings-descriptor.js +68 -3
  47. package/dist/src/lib/app-settings-descriptor.js.map +1 -1
  48. package/dist/src/lib/cli-manifest.d.ts +9 -0
  49. package/dist/src/lib/cli-manifest.js +19 -3
  50. package/dist/src/lib/cli-manifest.js.map +1 -1
  51. package/dist/src/lib/config-object-descriptor.js +3 -5
  52. package/dist/src/lib/config-object-descriptor.js.map +1 -1
  53. package/dist/src/lib/db3-export.js +1 -0
  54. package/dist/src/lib/db3-export.js.map +1 -1
  55. package/dist/src/lib/document-ingest.d.ts +7 -1
  56. package/dist/src/lib/document-ingest.js +27 -2
  57. package/dist/src/lib/document-ingest.js.map +1 -1
  58. package/dist/src/lib/function-authorize-check.js +5 -0
  59. package/dist/src/lib/function-authorize-check.js.map +1 -1
  60. package/dist/src/lib/function-authorize-view.js +5 -4
  61. package/dist/src/lib/function-authorize-view.js.map +1 -1
  62. package/dist/src/lib/function-bundle.d.ts +6 -0
  63. package/dist/src/lib/function-bundle.js +14 -0
  64. package/dist/src/lib/function-bundle.js.map +1 -1
  65. package/dist/src/lib/function-collect.d.ts +6 -0
  66. package/dist/src/lib/function-collect.js +10 -2
  67. package/dist/src/lib/function-collect.js.map +1 -1
  68. package/dist/src/lib/function-db-types.d.ts +8 -0
  69. package/dist/src/lib/function-db-types.js +15 -0
  70. package/dist/src/lib/function-db-types.js.map +1 -1
  71. package/dist/src/lib/function-log-lines.js +6 -1
  72. package/dist/src/lib/function-log-lines.js.map +1 -1
  73. package/dist/src/lib/function-log-row.d.ts +8 -0
  74. package/dist/src/lib/function-log-row.js +59 -0
  75. package/dist/src/lib/function-log-row.js.map +1 -1
  76. package/dist/src/lib/function-sync.d.ts +62 -0
  77. package/dist/src/lib/function-sync.js +68 -1
  78. package/dist/src/lib/function-sync.js.map +1 -1
  79. package/dist/src/lib/generated-command-status.js +6 -0
  80. package/dist/src/lib/generated-command-status.js.map +1 -1
  81. package/dist/src/lib/generated-config-surfaces.d.ts +104 -4
  82. package/dist/src/lib/generated-config-surfaces.js +378 -49
  83. package/dist/src/lib/generated-config-surfaces.js.map +1 -1
  84. package/dist/src/lib/generated-sdk-types.d.ts +1 -1
  85. package/dist/src/lib/generated-sdk-types.js +1 -1
  86. package/dist/src/lib/generated-sdk-types.js.map +1 -1
  87. package/dist/src/lib/log-inspection.d.ts +37 -2
  88. package/dist/src/lib/log-inspection.js +15 -3
  89. package/dist/src/lib/log-inspection.js.map +1 -1
  90. package/dist/src/lib/outside-project.d.ts +49 -0
  91. package/dist/src/lib/outside-project.js +133 -0
  92. package/dist/src/lib/outside-project.js.map +1 -0
  93. package/dist/src/lib/primitive-declaration.d.ts +8 -1
  94. package/dist/src/lib/primitive-declaration.js +40 -8
  95. package/dist/src/lib/primitive-declaration.js.map +1 -1
  96. package/dist/src/lib/schema-codegen/compiledSpace.d.ts +16 -0
  97. package/dist/src/lib/schema-codegen/compiledSpace.js +23 -11
  98. package/dist/src/lib/schema-codegen/compiledSpace.js.map +1 -1
  99. package/dist/src/lib/schema-codegen/generated-field-table.js +38 -3
  100. package/dist/src/lib/schema-codegen/generated-field-table.js.map +1 -1
  101. package/dist/src/lib/schema-codegen/generated-schema-refs.js +172 -19
  102. package/dist/src/lib/schema-codegen/generated-schema-refs.js.map +1 -1
  103. package/dist/src/lib/schema-codegen/namedRefs.js +8 -2
  104. package/dist/src/lib/schema-codegen/namedRefs.js.map +1 -1
  105. package/dist/src/lib/schema-codegen/schemaDocs.js +10 -4
  106. package/dist/src/lib/schema-codegen/schemaDocs.js.map +1 -1
  107. package/dist/src/lib/schema-codegen/schemaIR.d.ts +12 -2
  108. package/dist/src/lib/schema-codegen/schemaIR.js +26 -2
  109. package/dist/src/lib/schema-codegen/schemaIR.js.map +1 -1
  110. package/dist/src/lib/schema-codegen/schemaToTs.d.ts +2 -1
  111. package/dist/src/lib/schema-codegen/schemaToTs.js +8 -5
  112. package/dist/src/lib/schema-codegen/schemaToTs.js.map +1 -1
  113. package/dist/src/lib/usage-meters.js +1 -0
  114. package/dist/src/lib/usage-meters.js.map +1 -1
  115. package/dist/src/types/index.d.ts +9 -0
  116. package/package.json +2 -2
@@ -7,6 +7,7 @@ import { CLI_VERSION_HEADER, cliVersionHeaderValue } from "./cli-version.js";
7
7
  import { paginateAll, normalizeCliListEnvelope } from "./paginate.js";
8
8
  import { RefreshError } from "./refresh-admin-credentials.js";
9
9
  import { refreshFromStoredLogin } from "./refresh-stored-login.js";
10
+ import { createHash } from "crypto";
10
11
  /** The `X-Primitive-CLI-Version` value, read from the package file once per process. */
11
12
  let cliVersion;
12
13
  /**
@@ -1417,6 +1418,75 @@ export class ApiClient {
1417
1418
  async revokeAdminSession(sessionId) {
1418
1419
  return this.delete(`/admin/api/auth/sessions/${encodeURIComponent(sessionId)}`);
1419
1420
  }
1421
+ /** The caller's admin passkeys under every relying party, newest first (#5978). */
1422
+ async listAdminPasskeys() {
1423
+ const result = await this.get("/admin/api/auth/passkeys");
1424
+ return { items: result?.items ?? [], hasMore: Boolean(result?.hasMore) };
1425
+ }
1426
+ /**
1427
+ * One page of an admin's, or an address's, sign-in audit events, newest
1428
+ * first (super-admin). Exactly one of `adminId` and `email` is sent.
1429
+ */
1430
+ async listAdminAuthEvents(params) {
1431
+ const result = await this.get("/super-admin/api/auth-events", params);
1432
+ return {
1433
+ items: result?.items ?? [],
1434
+ hasMore: Boolean(result?.hasMore),
1435
+ nextCursor: result?.nextCursor ?? null,
1436
+ };
1437
+ }
1438
+ /** Delete one of the caller's admin passkeys (#5978). */
1439
+ async deleteAdminPasskey(passkeyId) {
1440
+ return this.delete(`/admin/api/auth/passkeys/${encodeURIComponent(passkeyId)}`);
1441
+ }
1442
+ /**
1443
+ * Reset another admin's sign-in (#5978, super-admin): clear their passkeys
1444
+ * and bound Google account. The route needs an unpinned `admin` step-up,
1445
+ * so a usable stored one is sent first; otherwise the login is, and the
1446
+ * server's refusal names the step-up command.
1447
+ */
1448
+ async resetAdminSignIn(adminId) {
1449
+ const path = `/super-admin/api/admins/${encodeURIComponent(adminId)}/reset-sign-in`;
1450
+ const withStepUp = await this.sendWithAdminStepUp(path, "POST");
1451
+ if (withStepUp.sent)
1452
+ return withStepUp.body;
1453
+ return this.request(path, { method: "POST" });
1454
+ }
1455
+ /**
1456
+ * Send one request with the stored step-up when it can act on a platform
1457
+ * route that needs `admin`: unexpired, holding `admin`, and unpinned.
1458
+ * Answers `{ sent: false }` when there is no such step-up, or when the
1459
+ * server answered it 401 (it is dropped); the caller then sends the login.
1460
+ * Any other refusal throws as `request` would.
1461
+ */
1462
+ async sendWithAdminStepUp(path, method) {
1463
+ const credentials = await this.ensureAuthenticated();
1464
+ const stepUp = credentials.stepUp;
1465
+ const usable = Boolean(stepUp?.accessToken) &&
1466
+ new Date(stepUp.expiresAt).getTime() > Date.now() &&
1467
+ (stepUp.scope ?? []).includes("admin") &&
1468
+ (stepUp.apps ?? []).length === 0;
1469
+ if (!usable)
1470
+ return { sent: false };
1471
+ const headers = {
1472
+ Authorization: `Bearer ${stepUp.accessToken}`,
1473
+ "Content-Type": "application/json",
1474
+ [CLI_VERSION_HEADER]: (cliVersion ??= cliVersionHeaderValue()),
1475
+ };
1476
+ if (credentials.globalAdminAppId) {
1477
+ headers["X-Global-Admin-App-Id"] = credentials.globalAdminAppId;
1478
+ }
1479
+ const response = await fetchWithTLS(`${credentials.serverUrl}${path}`, { method, headers });
1480
+ const text = await response.text();
1481
+ if (response.status === 401) {
1482
+ this.dropStepUp();
1483
+ return { sent: false };
1484
+ }
1485
+ if (!response.ok)
1486
+ throw this.responseError(response, text, path);
1487
+ this.lastStatus = response.status;
1488
+ return { sent: true, body: (text ? JSON.parse(text) : null) };
1489
+ }
1420
1490
  // ============================================
1421
1491
  // NAMED LOCKS (#1518)
1422
1492
  // ============================================
@@ -1878,6 +1948,10 @@ export class ApiClient {
1878
1948
  async getUsageJobs() {
1879
1949
  return this.get("/super-admin/api/maintenance/usage/jobs");
1880
1950
  }
1951
+ /** The whole platform's metered usage for a month, by app, meter or day (super-admin). */
1952
+ async getUsagePlatform(params) {
1953
+ return this.get("/super-admin/api/maintenance/usage/platform", params);
1954
+ }
1881
1955
  // ============================================
1882
1956
  // SUPER ADMIN: ADMINS
1883
1957
  // ============================================
@@ -3575,14 +3649,22 @@ export class ApiClient {
3575
3649
  hasMore: result?.hasMore ?? nextCursor != null,
3576
3650
  };
3577
3651
  }
3578
- async uploadBucketBlob(appId, bucketIdOrKey, data, meta) {
3652
+ /**
3653
+ * Store `data` in a bucket under `blobId` (a ULID), with its size and
3654
+ * SHA-256 (#6244). The same bytes again answer 200 with
3655
+ * `bytesTransferred: 0`; other bytes under the id are refused (409).
3656
+ */
3657
+ async uploadBucketBlob(appId, bucketIdOrKey, blobId, data, meta) {
3579
3658
  const credentials = await this.ensureAuthenticated();
3580
- const url = `${credentials.serverUrl}/app/${appId}/api/blob-buckets/${encodeURIComponent(bucketIdOrKey)}/blobs`;
3659
+ const url = `${credentials.serverUrl}/app/${appId}/api/blob-buckets/${encodeURIComponent(bucketIdOrKey)}/blobs/${encodeURIComponent(blobId)}`;
3660
+ const sha256 = createHash("sha256").update(data).digest("base64");
3581
3661
  const response = await this.fetchWithStepUp(url, url, credentials.accessToken, (bearer) => {
3582
3662
  const headers = {
3583
3663
  Authorization: `Bearer ${bearer}`,
3584
3664
  "Content-Type": meta.contentType,
3585
3665
  "X-Blob-Filename": encodeURIComponent(meta.filename),
3666
+ "X-Blob-Size": String(data.byteLength),
3667
+ "X-Blob-Sha256": sha256,
3586
3668
  };
3587
3669
  if (meta.tags && meta.tags.length > 0) {
3588
3670
  headers["X-Blob-Tags"] = JSON.stringify(meta.tags);
@@ -3590,16 +3672,16 @@ export class ApiClient {
3590
3672
  if (credentials.globalAdminAppId) {
3591
3673
  headers["X-Global-Admin-App-Id"] = credentials.globalAdminAppId;
3592
3674
  }
3593
- return { method: "POST", headers, body: data };
3675
+ return { method: "PUT", headers, body: data };
3594
3676
  });
3595
3677
  if (!response.ok) {
3596
3678
  throw await blobFailure(response, "Failed to upload blob: ");
3597
3679
  }
3598
- return response.json();
3680
+ return (await response.json());
3599
3681
  }
3600
3682
  async downloadBucketBlob(appId, bucketIdOrKey, blobId) {
3601
3683
  const credentials = await this.ensureAuthenticated();
3602
- const url = `${credentials.serverUrl}/app/${appId}/api/blob-buckets/${encodeURIComponent(bucketIdOrKey)}/blobs/${blobId}`;
3684
+ const url = `${credentials.serverUrl}/app/${appId}/api/blob-buckets/${encodeURIComponent(bucketIdOrKey)}/blobs/${encodeURIComponent(blobId)}/download`;
3603
3685
  const headers = {
3604
3686
  Authorization: `Bearer ${credentials.accessToken}`,
3605
3687
  };
@@ -3625,11 +3707,10 @@ export class ApiClient {
3625
3707
  expiresInSeconds: expiresInSeconds || 300,
3626
3708
  });
3627
3709
  }
3628
- // Blob metadata (#1966): head a single blob without downloading its bytes.
3629
- // Mirrors listBucketBlobs/downloadBucketBlob addressing; the server heads the
3630
- // R2 object and returns the serialized BlobInfo shape.
3710
+ // Blob metadata (#1966): a single blob without its bytes, read on the bare
3711
+ // blob path (#6244). The server heads the R2 object and returns BlobInfo.
3631
3712
  async getBucketBlobMetadata(appId, bucketIdOrKey, blobId) {
3632
- return this.get(`/app/${appId}/api/blob-buckets/${encodeURIComponent(bucketIdOrKey)}/blobs/${blobId}/metadata`);
3713
+ return this.get(`/app/${appId}/api/blob-buckets/${encodeURIComponent(bucketIdOrKey)}/blobs/${encodeURIComponent(blobId)}`);
3633
3714
  }
3634
3715
  }
3635
3716
  //# sourceMappingURL=api-client.js.map