@fabrika/provider-contract 0.9.0-cloudflare.1 → 0.9.0-cloudflare.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.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@fabrika/provider-contract",
3
- "version": "0.9.0-cloudflare.1",
3
+ "version": "0.9.0-cloudflare.3",
4
4
  "type": "module",
5
5
  "repository": {
6
6
  "type": "git",
@@ -42,7 +42,7 @@
42
42
  "test": "bun test"
43
43
  },
44
44
  "dependencies": {
45
- "@fabrika/auth-core": "0.9.0-cloudflare.1",
46
- "@fabrika/proxy-core": "0.9.0-cloudflare.1"
45
+ "@fabrika/auth-core": "0.9.0-cloudflare.3",
46
+ "@fabrika/proxy-core": "0.9.0-cloudflare.3"
47
47
  }
48
48
  }
package/src/control.ts CHANGED
@@ -1,4 +1,4 @@
1
- import type { AppSchema, ContractArtifact, ManagedEnvironment } from '@fabrika/auth-core'
1
+ import type { ApplicationObjects, AppSchema, ContractArtifact, ManagedEnvironment } from '@fabrika/auth-core'
2
2
  import type { InstallationBrand } from '@fabrika/proxy-core/brand'
3
3
  import type { JsonValue, ProviderEnvelope } from './json'
4
4
 
@@ -67,6 +67,12 @@ export interface ProviderApprovedAccess {
67
67
  * the framework minor it pins (ADR-0062). Its build checks with that release.
68
68
  */
69
69
  readonly checker: string
70
+ /**
71
+ * The `@fabrika/app` release the application's `bun.lock` pins (`FRAMEWORK_RELEASE_PATTERN`), which a release gate
72
+ * reads: `checker` is this platform's patch of that minor, newer than a prerelease pin. Absent in an access Control
73
+ * approved before it recorded the pin.
74
+ */
75
+ readonly framework?: string
70
76
  }
71
77
 
72
78
  /**
@@ -154,6 +160,11 @@ export interface ProviderDeployInput {
154
160
  readonly vars: Readonly<Record<string, string>>
155
161
  /** Platform-owned runtime configuration, separate from operator-managed application vars. */
156
162
  readonly managedEnvironment: ProviderManagedEnvironment
163
+ /**
164
+ * The object that serves the environment's ordinary traffic and the objects its ops channel reaches, as Control records
165
+ * them (ADR-0070 §9). A provider whose application runs in no object ignores it; absent, the provider's defaults.
166
+ */
167
+ readonly applicationObjects?: ApplicationObjects
157
168
  readonly dryRun: boolean
158
169
  readonly sourceBinding?: ProviderSourceBinding
159
170
  /** Optional short-lived, run-scoped Operations artifact destination. */
@@ -573,6 +584,13 @@ export interface ControlProvider {
573
584
  * release logic. Absent means no environment of this provider is.
574
585
  */
575
586
  opsChannel?(access: ProviderApprovedAccess): boolean
587
+ /**
588
+ * Whether the object at this approved access, served the ops channel, also holds the maintenance barrier (`state`,
589
+ * `migrate`) and serves Control's data operations: the daily backups, a deploy's migration phase and the side restore
590
+ * (ADR-0069 §3, ADR-0070). A release can serve the channel without them. Absent means no environment of this
591
+ * provider is.
592
+ */
593
+ dataOperations?(access: ProviderApprovedAccess): boolean
576
594
  /** Absent means the provider deploys public sources only. */
577
595
  readonly source?: ProviderSourceCapabilities
578
596
  /**
@@ -1,4 +1,4 @@
1
- import type { AppSchema, ContractArtifact, ManagedEnvironment } from '@fabrika/auth-core';
1
+ import type { ApplicationObjects, AppSchema, ContractArtifact, ManagedEnvironment } from '@fabrika/auth-core';
2
2
  import type { InstallationBrand } from '@fabrika/proxy-core/brand';
3
3
  import type { JsonValue, ProviderEnvelope } from './json';
4
4
  /** Events whose persistence and presentation belong to the control plane. */
@@ -60,6 +60,12 @@ export interface ProviderApprovedAccess {
60
60
  * the framework minor it pins (ADR-0062). Its build checks with that release.
61
61
  */
62
62
  readonly checker: string;
63
+ /**
64
+ * The `@fabrika/app` release the application's `bun.lock` pins (`FRAMEWORK_RELEASE_PATTERN`), which a release gate
65
+ * reads: `checker` is this platform's patch of that minor, newer than a prerelease pin. Absent in an access Control
66
+ * approved before it recorded the pin.
67
+ */
68
+ readonly framework?: string;
63
69
  }
64
70
  /**
65
71
  * `dev`: the environment follows a workspace through a platform-owned launcher, which its provider starts instead of the
@@ -138,6 +144,11 @@ export interface ProviderDeployInput {
138
144
  readonly vars: Readonly<Record<string, string>>;
139
145
  /** Platform-owned runtime configuration, separate from operator-managed application vars. */
140
146
  readonly managedEnvironment: ProviderManagedEnvironment;
147
+ /**
148
+ * The object that serves the environment's ordinary traffic and the objects its ops channel reaches, as Control records
149
+ * them (ADR-0070 §9). A provider whose application runs in no object ignores it; absent, the provider's defaults.
150
+ */
151
+ readonly applicationObjects?: ApplicationObjects;
141
152
  readonly dryRun: boolean;
142
153
  readonly sourceBinding?: ProviderSourceBinding;
143
154
  /** Optional short-lived, run-scoped Operations artifact destination. */
@@ -500,6 +511,13 @@ export interface ControlProvider {
500
511
  * release logic. Absent means no environment of this provider is.
501
512
  */
502
513
  opsChannel?(access: ProviderApprovedAccess): boolean;
514
+ /**
515
+ * Whether the object at this approved access, served the ops channel, also holds the maintenance barrier (`state`,
516
+ * `migrate`) and serves Control's data operations: the daily backups, a deploy's migration phase and the side restore
517
+ * (ADR-0069 §3, ADR-0070). A release can serve the channel without them. Absent means no environment of this
518
+ * provider is.
519
+ */
520
+ dataOperations?(access: ProviderApprovedAccess): boolean;
503
521
  /** Absent means the provider deploys public sources only. */
504
522
  readonly source?: ProviderSourceCapabilities;
505
523
  /**