@spacefast/common 0.0.12 → 0.0.17

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 (189) hide show
  1. package/dist/agents/client-registry.d.ts +22 -0
  2. package/dist/agents/client-registry.js +41 -0
  3. package/dist/agents/connect-targets.d.ts +51 -6
  4. package/dist/agents/connect-targets.js +93 -28
  5. package/dist/brand.d.ts +0 -11
  6. package/dist/brand.js +0 -20
  7. package/dist/config/domains.d.ts +15 -6
  8. package/dist/config/domains.js +24 -10
  9. package/dist/config/postgres-budget.d.ts +3 -0
  10. package/dist/config/postgres-budget.js +6 -1
  11. package/dist/config/postgres-budget.json +2 -1
  12. package/dist/contracts/abuse.js +1 -1
  13. package/dist/contracts/access.d.ts +486 -1196
  14. package/dist/contracts/access.js +323 -1054
  15. package/dist/contracts/activity.d.ts +1 -1
  16. package/dist/contracts/activity.js +11 -15
  17. package/dist/contracts/api-keys.d.ts +16 -0
  18. package/dist/contracts/api-keys.js +11 -9
  19. package/dist/contracts/archives.d.ts +1 -2
  20. package/dist/contracts/archives.js +15 -17
  21. package/dist/contracts/beta.js +1 -1
  22. package/dist/contracts/builds.js +14 -14
  23. package/dist/contracts/channels.js +2 -2
  24. package/dist/contracts/comments.d.ts +143 -99
  25. package/dist/contracts/comments.js +194 -79
  26. package/dist/contracts/common.d.ts +12 -12
  27. package/dist/contracts/common.js +33 -30
  28. package/dist/contracts/continuation.js +5 -5
  29. package/dist/contracts/countries.js +2 -7
  30. package/dist/contracts/data-source-routes.d.ts +20 -0
  31. package/dist/contracts/data-source-routes.js +15 -0
  32. package/dist/contracts/device-auth.d.ts +13 -9
  33. package/dist/contracts/device-auth.js +12 -12
  34. package/dist/contracts/docs.d.ts +10 -10
  35. package/dist/contracts/domains.js +39 -33
  36. package/dist/contracts/enums.d.ts +4 -14
  37. package/dist/contracts/enums.js +3 -10
  38. package/dist/contracts/error-code-meta.d.ts +122 -56
  39. package/dist/contracts/error-code-meta.js +43 -19
  40. package/dist/contracts/error-codes.d.ts +7 -4
  41. package/dist/contracts/error-codes.js +48 -24
  42. package/dist/contracts/events.d.ts +22 -15
  43. package/dist/contracts/events.js +33 -5
  44. package/dist/contracts/execution.d.ts +238 -0
  45. package/dist/contracts/execution.js +309 -0
  46. package/dist/contracts/feature-lifecycle.d.ts +39 -188
  47. package/dist/contracts/feature-lifecycle.js +52 -196
  48. package/dist/contracts/features.d.ts +13 -115
  49. package/dist/contracts/features.js +5 -35
  50. package/dist/contracts/functions.d.ts +597 -0
  51. package/dist/contracts/functions.js +475 -0
  52. package/dist/contracts/grants.d.ts +1175 -0
  53. package/dist/contracts/grants.js +783 -0
  54. package/dist/contracts/ids.d.ts +7 -5
  55. package/dist/contracts/ids.js +7 -7
  56. package/dist/contracts/internal.js +2 -2
  57. package/dist/contracts/mcp.d.ts +17 -556
  58. package/dist/contracts/mcp.js +9 -103
  59. package/dist/contracts/me.js +3 -4
  60. package/dist/contracts/notifications.d.ts +108 -0
  61. package/dist/contracts/notifications.js +54 -0
  62. package/dist/contracts/oauth-resources.d.ts +22 -5
  63. package/dist/contracts/oauth-resources.js +23 -2
  64. package/dist/contracts/operations.d.ts +0 -48
  65. package/dist/contracts/operations.js +0 -19
  66. package/dist/contracts/pages.d.ts +10 -14
  67. package/dist/contracts/pages.js +17 -21
  68. package/dist/contracts/plan-policy.d.ts +1 -8
  69. package/dist/contracts/plan-policy.js +1 -4
  70. package/dist/contracts/platform.d.ts +78 -30
  71. package/dist/contracts/platform.js +69 -20
  72. package/dist/contracts/problem-document.d.ts +14 -0
  73. package/dist/contracts/problem-document.js +35 -0
  74. package/dist/contracts/push-new.d.ts +41 -2
  75. package/dist/contracts/push-new.js +4 -0
  76. package/dist/contracts/quotas.d.ts +0 -1
  77. package/dist/contracts/quotas.js +0 -5
  78. package/dist/contracts/repository-connections.d.ts +1 -1
  79. package/dist/contracts/resources.d.ts +16 -71
  80. package/dist/contracts/resources.js +13 -16
  81. package/dist/contracts/runtime-api.d.ts +666 -303
  82. package/dist/contracts/runtime-api.js +272 -113
  83. package/dist/contracts/runtime-app.d.ts +168 -0
  84. package/dist/contracts/runtime-app.js +42 -0
  85. package/dist/contracts/runtime-db.d.ts +424 -0
  86. package/dist/contracts/runtime-db.js +108 -0
  87. package/dist/contracts/runtime-storage.d.ts +120 -0
  88. package/dist/contracts/runtime-storage.js +40 -0
  89. package/dist/contracts/sf-config-v1.d.ts +54 -1
  90. package/dist/contracts/sf-config-v1.js +2 -2
  91. package/dist/contracts/sites.d.ts +6 -0
  92. package/dist/contracts/sites.js +30 -11
  93. package/dist/contracts/space-config.d.ts +91 -121
  94. package/dist/contracts/space-config.js +464 -42
  95. package/dist/contracts/spaces.d.ts +300 -171
  96. package/dist/contracts/spaces.js +128 -98
  97. package/dist/contracts/superadmin-emails.d.ts +2 -2
  98. package/dist/contracts/superadmin-spaces.d.ts +26 -130
  99. package/dist/contracts/superadmin-spaces.js +22 -0
  100. package/dist/contracts/superadmin-tenants.js +4 -4
  101. package/dist/contracts/superadmin.d.ts +4 -0
  102. package/dist/contracts/superadmin.js +14 -1
  103. package/dist/contracts/tags.d.ts +6 -6
  104. package/dist/contracts/tags.js +1 -1
  105. package/dist/contracts/teams.d.ts +9 -9
  106. package/dist/contracts/teams.js +25 -16
  107. package/dist/contracts/theme-json.js +1 -1
  108. package/dist/contracts/transfers.d.ts +0 -1
  109. package/dist/contracts/transfers.js +4 -4
  110. package/dist/contracts/variables.js +3 -3
  111. package/dist/contracts/zero.d.ts +384 -596
  112. package/dist/contracts/zero.js +167 -299
  113. package/dist/dashboard-paths/index.d.ts +18 -3
  114. package/dist/dashboard-paths/index.js +19 -0
  115. package/dist/docs/agent-handoff-document.d.ts +2 -2
  116. package/dist/docs/agent-handoff-document.js +8 -7
  117. package/dist/docs/agent-prose.d.ts +22 -3
  118. package/dist/docs/agent-prose.js +227 -55
  119. package/dist/docs/agent-setup.d.ts +14 -11
  120. package/dist/docs/agent-setup.js +289 -61
  121. package/dist/docs/agent-solutions.d.ts +6 -6
  122. package/dist/docs/agent-solutions.js +24 -22
  123. package/dist/docs/catalog.d.ts +53 -98
  124. package/dist/docs/catalog.js +90 -117
  125. package/dist/docs/error-docs.js +304 -236
  126. package/dist/docs/skill-distribution.d.ts +2 -0
  127. package/dist/docs/skill-distribution.js +7 -4
  128. package/dist/docs/skills.d.ts +546 -0
  129. package/dist/docs/skills.js +340 -0
  130. package/dist/utils/auth-redirect.d.ts +1 -3
  131. package/dist/utils/auth-redirect.js +1 -21
  132. package/dist/utils/browser-credential.d.ts +19 -0
  133. package/dist/utils/browser-credential.js +62 -0
  134. package/dist/utils/build-settings.d.ts +2 -0
  135. package/dist/utils/build-settings.js +61 -9
  136. package/dist/utils/comment-avatars.d.ts +7 -0
  137. package/dist/utils/comment-avatars.js +42 -0
  138. package/dist/utils/content-type.d.ts +3 -3
  139. package/dist/utils/content-type.js +38 -61
  140. package/dist/utils/credential-policy.d.ts +1 -1
  141. package/dist/utils/credential-policy.js +4 -0
  142. package/dist/utils/domain-diagnostics.d.ts +5 -5
  143. package/dist/utils/domain-diagnostics.js +21 -10
  144. package/dist/utils/egress-policy.fixtures.json +1 -1
  145. package/dist/utils/grants.d.ts +53 -0
  146. package/dist/utils/grants.js +160 -0
  147. package/dist/utils/local-space-state.d.ts +78 -4
  148. package/dist/utils/local-space-state.js +384 -82
  149. package/dist/utils/one-shot-replay.d.ts +14 -0
  150. package/dist/utils/one-shot-replay.js +21 -0
  151. package/dist/utils/page-preview.d.ts +7 -0
  152. package/dist/utils/page-preview.js +9 -0
  153. package/dist/utils/pages.d.ts +2 -5
  154. package/dist/utils/pages.js +64 -33
  155. package/dist/utils/publish-form-data.d.ts +22 -0
  156. package/dist/utils/publish-form-data.js +26 -0
  157. package/dist/utils/publish-policy.d.ts +34 -4
  158. package/dist/utils/publish-policy.js +149 -62
  159. package/dist/utils/query-keys.d.ts +8 -10
  160. package/dist/utils/query-keys.js +14 -10
  161. package/dist/utils/runtime-paths.d.ts +3 -0
  162. package/dist/utils/runtime-paths.js +7 -0
  163. package/dist/utils/secure-local-file.d.ts +73 -0
  164. package/dist/utils/secure-local-file.js +1373 -0
  165. package/dist/utils/space-config.d.ts +17 -4
  166. package/dist/utils/space-config.js +151 -8
  167. package/dist/utils/static-runtime-policy.d.ts +5 -0
  168. package/dist/utils/static-runtime-policy.js +54 -10
  169. package/dist/utils/storage-policy.d.ts +20 -0
  170. package/dist/utils/storage-policy.fixtures.json +174 -0
  171. package/dist/utils/storage-policy.js +193 -0
  172. package/dist/utils/upload-session.d.ts +15 -1
  173. package/dist/utils/upload-session.js +68 -2
  174. package/dist/utils/version-file-browser.d.ts +13 -0
  175. package/dist/utils/version-file-browser.js +59 -0
  176. package/package.json +20 -1
  177. package/dist/contracts/mounts.d.ts +0 -142
  178. package/dist/contracts/mounts.js +0 -56
  179. package/dist/utils/access-grant.d.ts +0 -14
  180. package/dist/utils/access-grant.js +0 -88
  181. package/dist/utils/access-match.d.ts +0 -46
  182. package/dist/utils/access-match.fixtures.json +0 -513
  183. package/dist/utils/access-match.js +0 -312
  184. package/dist/utils/access-verdict.fixtures.json +0 -421
  185. package/dist/utils/asset-fingerprint.d.ts +0 -53
  186. package/dist/utils/asset-fingerprint.js +0 -574
  187. package/dist/utils/sf-config-v1.d.ts +0 -2
  188. package/dist/utils/sf-config-v1.fixtures.json +0 -9
  189. package/dist/utils/sf-config-v1.js +0 -551
@@ -67,7 +67,6 @@ export declare const SpaceSchema: z.ZodObject<{
67
67
  abuse_takedown: "abuse_takedown";
68
68
  tenant_suspended: "tenant_suspended";
69
69
  site_suspended: "site_suspended";
70
- visit_cap_exceeded: "visit_cap_exceeded";
71
70
  }>;
72
71
  }, z.core.$strip>>;
73
72
  claimState: z.ZodNullable<z.ZodObject<{
@@ -106,6 +105,7 @@ export declare const SpaceSchema: z.ZodObject<{
106
105
  always_hot: "always_hot";
107
106
  }>;
108
107
  moving: z.ZodBoolean;
108
+ hasRuntime: z.ZodBoolean;
109
109
  channels: z.ZodRecord<z.ZodString, z.ZodObject<{
110
110
  versionId: z.ZodString;
111
111
  updatedAt: z.ZodString;
@@ -188,73 +188,14 @@ export declare const SpaceSchema: z.ZodObject<{
188
188
  bodyEnd: z.ZodOptional<z.ZodArray<z.ZodString>>;
189
189
  noscript: z.ZodOptional<z.ZodArray<z.ZodString>>;
190
190
  }, z.core.$strip>>;
191
+ dataSources: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodRecord<z.ZodString, z.ZodObject<{
192
+ kind: z.ZodLiteral<"wordpress">;
193
+ url: z.ZodString;
194
+ }, z.core.$strict>>>>;
195
+ defaultDataSource: z.ZodOptional<z.ZodString>;
191
196
  }, z.core.$strip>>;
192
197
  settingsDigest: z.ZodString;
193
198
  noindex: z.ZodBoolean;
194
- policy: z.ZodNullable<z.ZodObject<{
195
- rules: z.ZodDefault<z.ZodArray<z.ZodObject<{
196
- id: z.ZodOptional<z.ZodString>;
197
- match: z.ZodDefault<z.ZodObject<{
198
- host: z.ZodOptional<z.ZodString>;
199
- hostPattern: z.ZodOptional<z.ZodString>;
200
- hostTemplate: z.ZodOptional<z.ZodString>;
201
- pathPattern: z.ZodOptional<z.ZodString>;
202
- channel: z.ZodOptional<z.ZodString>;
203
- ipCidrs: z.ZodOptional<z.ZodArray<z.ZodString>>;
204
- agent: z.ZodOptional<z.ZodString>;
205
- country: z.ZodOptional<z.ZodString>;
206
- countryNotIn: z.ZodOptional<z.ZodArray<z.ZodString>>;
207
- header: z.ZodOptional<z.ZodObject<{
208
- name: z.ZodString;
209
- value: z.ZodString;
210
- }, z.core.$strip>>;
211
- }, z.core.$strip>>;
212
- effect: z.ZodEnum<{
213
- allow: "allow";
214
- deny: "deny";
215
- challenge: "challenge";
216
- }>;
217
- auth: z.ZodOptional<z.ZodObject<{
218
- requiredGrants: z.ZodArray<z.ZodString>;
219
- issuers: z.ZodOptional<z.ZodArray<z.ZodObject<{
220
- kid: z.ZodString;
221
- alg: z.ZodLiteral<"EdDSA">;
222
- publicKey: z.ZodString;
223
- grantNamespaces: z.ZodArray<z.ZodString>;
224
- }, z.core.$strip>>>;
225
- acquire: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
226
- type: z.ZodLiteral<"password">;
227
- ref: z.ZodString;
228
- transport: z.ZodEnum<{
229
- basic: "basic";
230
- form: "form";
231
- }>;
232
- username: z.ZodOptional<z.ZodString>;
233
- }, z.core.$strip>, z.ZodObject<{
234
- type: z.ZodLiteral<"login">;
235
- url: z.ZodString;
236
- label: z.ZodOptional<z.ZodString>;
237
- }, z.core.$strip>], "type">>>;
238
- }, z.core.$strip>>;
239
- managedBy: z.ZodOptional<z.ZodEnum<{
240
- sharing: "sharing";
241
- firewall: "firewall";
242
- file_share: "file_share";
243
- cast_reviewer: "cast_reviewer";
244
- team_default: "team_default";
245
- }>>;
246
- expiresAt: z.ZodOptional<z.ZodNumber>;
247
- reasonCode: z.ZodOptional<z.ZodString>;
248
- message: z.ZodOptional<z.ZodString>;
249
- }, z.core.$strip>>>;
250
- issuers: z.ZodOptional<z.ZodArray<z.ZodObject<{
251
- kid: z.ZodString;
252
- alg: z.ZodLiteral<"EdDSA">;
253
- publicKey: z.ZodString;
254
- grantNamespaces: z.ZodArray<z.ZodString>;
255
- }, z.core.$strip>>>;
256
- sessionVersion: z.ZodOptional<z.ZodNumber>;
257
- }, z.core.$strip>>;
258
199
  operation: z.ZodNullable<z.ZodObject<{
259
200
  id: z.ZodString;
260
201
  kind: z.ZodString;
@@ -301,10 +242,10 @@ export declare const SpaceSchema: z.ZodObject<{
301
242
  }, z.core.$strip>;
302
243
  export declare const PublishSourceSchema: z.ZodObject<{
303
244
  kind: z.ZodEnum<{
304
- api: "api";
305
- dashboard: "dashboard";
306
245
  build: "build";
307
246
  agent: "agent";
247
+ api: "api";
248
+ dashboard: "dashboard";
308
249
  direct_upload: "direct_upload";
309
250
  cli: "cli";
310
251
  git: "git";
@@ -338,10 +279,10 @@ export declare const VersionSchema: z.ZodObject<{
338
279
  spaceId: z.ZodString;
339
280
  source: z.ZodNullable<z.ZodObject<{
340
281
  kind: z.ZodEnum<{
341
- api: "api";
342
- dashboard: "dashboard";
343
282
  build: "build";
344
283
  agent: "agent";
284
+ api: "api";
285
+ dashboard: "dashboard";
345
286
  direct_upload: "direct_upload";
346
287
  cli: "cli";
347
288
  git: "git";
@@ -480,6 +421,11 @@ export declare const VersionSchema: z.ZodObject<{
480
421
  bodyEnd: z.ZodOptional<z.ZodArray<z.ZodString>>;
481
422
  noscript: z.ZodOptional<z.ZodArray<z.ZodString>>;
482
423
  }, z.core.$strip>>;
424
+ dataSources: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodRecord<z.ZodString, z.ZodObject<{
425
+ kind: z.ZodLiteral<"wordpress">;
426
+ url: z.ZodString;
427
+ }, z.core.$strict>>>>;
428
+ defaultDataSource: z.ZodOptional<z.ZodString>;
483
429
  }, z.core.$strip>>;
484
430
  operation: z.ZodNullable<z.ZodObject<{
485
431
  id: z.ZodString;
@@ -525,7 +471,7 @@ export declare const VersionSchema: z.ZodObject<{
525
471
  headersRuleCount: z.ZodNumber;
526
472
  redirectsRuleCount: z.ZodNumber;
527
473
  proxyRouteCount: z.ZodNumber;
528
- functionsDetected: z.ZodBoolean;
474
+ runtimeCodeDetected: z.ZodBoolean;
529
475
  buildLog: z.ZodNullable<z.ZodString>;
530
476
  diagnostics: z.ZodDefault<z.ZodArray<z.ZodObject<{
531
477
  code: z.ZodString;
@@ -551,7 +497,6 @@ export declare const VersionSchema: z.ZodObject<{
551
497
  }, z.core.$strip>>>;
552
498
  createdAt: z.ZodString;
553
499
  readyAt: z.ZodNullable<z.ZodString>;
554
- accessibleUntil: z.ZodNullable<z.ZodString>;
555
500
  retainedUntil: z.ZodNullable<z.ZodString>;
556
501
  updatedAt: z.ZodString;
557
502
  }, z.core.$strip>;
@@ -1,5 +1,4 @@
1
1
  import { z } from "zod";
2
- import { policyDocSchema } from "./access.js";
3
2
  import { AsyncOperationSchema, baseDiagnosticSchema } from "./common.js";
4
3
  import { normalizedSiteClass, publishSourceKind, versionStatus, spaceDisabledReasonCode, spaceStatus, } from "./enums.js";
5
4
  import { pendingUploadSchema } from "./internal.js";
@@ -63,8 +62,8 @@ export const SpaceSchema = z.object({
63
62
  expiryExtension: z.object({ extendedTo: z.string().datetime() }).nullable().optional(),
64
63
  defaultHostname: z
65
64
  .string()
66
- .describe("Stable Spacefast-owned default hostname, built from the public project name under view.fast; survives slug renames."),
67
- publicName: z.string().describe("Public project label used in the managed view.fast hostname."),
65
+ .describe("Current Spacefast-owned managed hostname under view.fast. Renaming the space changes this hostname; previously managed hostnames temporarily redirect to the current one."),
66
+ publicName: z.string().describe("Public space label used in the managed view.fast hostname."),
68
67
  liveUrl: z
69
68
  .string()
70
69
  .describe("Live space URL: the primary bound domain when one exists, else the default hostname. Always present on non-deleted spaces."),
@@ -87,17 +86,20 @@ export const SpaceSchema = z.object({
87
86
  burstable: z
88
87
  .boolean()
89
88
  .nullable()
90
- .describe("Whether a dedicated placement may burst provider PHP workers."),
89
+ .describe("Whether a dedicated placement can burst provider PHP workers."),
91
90
  archivedBytes: z
92
91
  .number()
93
92
  .int()
94
93
  .nonnegative()
95
94
  .describe("Bytes currently archived out of the hot runtime store."),
96
95
  tierPolicy: z.enum(["auto", "always_hot"]).describe("Storage tiering policy for this space."),
97
- moving: z.boolean().describe("True while a placement or transfer move is queued or running."),
96
+ moving: z.boolean().describe("Whether a placement or transfer move is queued or running."),
97
+ hasRuntime: z
98
+ .boolean()
99
+ .describe("Whether this space's live version runs code and therefore has a Runtime surface. Feature eligibility alone does not make the surface visible."),
98
100
  channels: z
99
101
  .record(z.string(), ChannelPointerSchema)
100
- .describe('Channel pointers by name; "live" is present once a version has been promoted.'),
102
+ .describe('Channel pointers by name. "live" is present after a version is promoted.'),
101
103
  config: spaceConfigSchema
102
104
  .nullable()
103
105
  .describe("Stored SpaceConfig overlay applied over the live version's sf.jsonc; null when nothing is overridden."),
@@ -105,9 +107,6 @@ export const SpaceSchema = z.object({
105
107
  noindex: z
106
108
  .boolean()
107
109
  .describe("When true, the live production hostnames serve platform noindex directives. Immutable version and preview hostnames are always noindex regardless of this setting."),
108
- policy: policyDocSchema
109
- .nullable()
110
- .describe("Deprecated space-level access projection. Use /v1/spaces/{spaceId}/access and /effective for the unified policy lane."),
111
110
  operation: AsyncOperationSchema.nullable(),
112
111
  createdAt: z.string().datetime(),
113
112
  updatedAt: z.string().datetime(),
@@ -133,7 +132,7 @@ export const PublishSourceSchema = z.object({
133
132
  dirty: z
134
133
  .boolean()
135
134
  .optional()
136
- .describe("True when the working tree had uncommitted changes at publish time."),
135
+ .describe("Whether the working tree had uncommitted changes at publish time."),
137
136
  metadata: z
138
137
  .record(z.string(), z.string())
139
138
  .optional()
@@ -197,17 +196,15 @@ export const VersionSchema = z.object({
197
196
  headersRuleCount: z.number().int(),
198
197
  redirectsRuleCount: z.number().int(),
199
198
  proxyRouteCount: z.number().int(),
200
- functionsDetected: z.boolean(),
199
+ runtimeCodeDetected: z.boolean(),
201
200
  buildLog: z.string().nullable(),
202
201
  diagnostics: z.array(DiagnosticSchema).default([]),
203
202
  createdAt: z.string().datetime(),
204
203
  // Retention anchor: stamped when the version first reaches "ready".
205
204
  readyAt: z.string().datetime().nullable(),
206
- // Retention axes computed from plan policy at read time, never stored per row
207
- // (internal-docs/platform.md "Version retention"). Null = not subject to that
208
- // axis (live/channel-referenced, anonymous claim lifecycle, or the plan
209
- // retains indefinitely).
210
- accessibleUntil: z.string().datetime().nullable(),
205
+ // Storage retention deadline computed from plan policy at read time, never
206
+ // stored per row. Null = not subject to retention deletion
207
+ // (live/channel-referenced, anonymous claim lifecycle, or an unlimited plan).
211
208
  retainedUntil: z.string().datetime().nullable(),
212
209
  updatedAt: z.string().datetime(),
213
210
  });