@ankhorage/contracts 26.2.0 → 26.2.2

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 (266) hide show
  1. package/CHANGELOG.md +12 -0
  2. package/README.md +1 -1
  3. package/dist/appManifest/bindings.js +1 -1
  4. package/dist/appManifest/bindings.js.map +1 -1
  5. package/dist/appManifest/constants.js.map +1 -1
  6. package/dist/appManifest/dataSources.js +2 -2
  7. package/dist/appManifest/dataSources.js.map +1 -1
  8. package/dist/appManifest/isAppManifest.d.ts +1 -1
  9. package/dist/appManifest/isAppManifest.d.ts.map +1 -1
  10. package/dist/appManifest/isAppManifest.js +8 -8
  11. package/dist/appManifest/isAppManifest.js.map +1 -1
  12. package/dist/appManifest/isAppStateSpec.d.ts +1 -1
  13. package/dist/appManifest/isAppStateSpec.d.ts.map +1 -1
  14. package/dist/appManifest/isAppStateSpec.js.map +1 -1
  15. package/dist/appManifest/isManifestValue.js +1 -1
  16. package/dist/appManifest/isManifestValue.js.map +1 -1
  17. package/dist/appManifest/media.d.ts +1 -1
  18. package/dist/appManifest/media.d.ts.map +1 -1
  19. package/dist/appManifest/media.js +1 -1
  20. package/dist/appManifest/media.js.map +1 -1
  21. package/dist/appManifest/navigator.d.ts +1 -1
  22. package/dist/appManifest/navigator.d.ts.map +1 -1
  23. package/dist/appManifest/navigator.js +3 -3
  24. package/dist/appManifest/navigator.js.map +1 -1
  25. package/dist/appManifest/navigatorOptions.js +1 -1
  26. package/dist/appManifest/navigatorOptions.js.map +1 -1
  27. package/dist/appManifest/parseAppManifest.d.ts +1 -1
  28. package/dist/appManifest/parseAppManifest.d.ts.map +1 -1
  29. package/dist/appManifest/parseAppManifest.js +1 -1
  30. package/dist/appManifest/parseAppManifest.js.map +1 -1
  31. package/dist/appManifest/screens.d.ts +2 -2
  32. package/dist/appManifest/screens.d.ts.map +1 -1
  33. package/dist/appManifest/screens.js +6 -6
  34. package/dist/appManifest/screens.js.map +1 -1
  35. package/dist/appManifest.d.ts +4 -4
  36. package/dist/appManifest.d.ts.map +1 -1
  37. package/dist/appManifest.js +2 -2
  38. package/dist/appManifest.js.map +1 -1
  39. package/dist/auth.d.ts +5 -5
  40. package/dist/auth.d.ts.map +1 -1
  41. package/dist/auth.js.map +1 -1
  42. package/dist/bindings.d.ts +3 -3
  43. package/dist/bindings.d.ts.map +1 -1
  44. package/dist/bindings.js.map +1 -1
  45. package/dist/cli/index.d.ts +1 -1
  46. package/dist/cli/index.d.ts.map +1 -1
  47. package/dist/cli/index.js.map +1 -1
  48. package/dist/data/apis.d.ts +6 -6
  49. package/dist/data/apis.d.ts.map +1 -1
  50. package/dist/data/apis.js.map +1 -1
  51. package/dist/data/diagnostics.d.ts +1 -1
  52. package/dist/data/diagnostics.d.ts.map +1 -1
  53. package/dist/data/diagnostics.js.map +1 -1
  54. package/dist/data/endpoints.d.ts +5 -5
  55. package/dist/data/endpoints.d.ts.map +1 -1
  56. package/dist/data/endpoints.js.map +1 -1
  57. package/dist/data/index.d.ts +10 -10
  58. package/dist/data/index.d.ts.map +1 -1
  59. package/dist/data/index.js +10 -10
  60. package/dist/data/index.js.map +1 -1
  61. package/dist/data/isApiDefinitionRegistry.d.ts +1 -1
  62. package/dist/data/isApiDefinitionRegistry.d.ts.map +1 -1
  63. package/dist/data/isApiDefinitionRegistry.js +2 -2
  64. package/dist/data/isApiDefinitionRegistry.js.map +1 -1
  65. package/dist/data/operations.d.ts +5 -5
  66. package/dist/data/operations.d.ts.map +1 -1
  67. package/dist/data/operations.js.map +1 -1
  68. package/dist/data/refs.d.ts +2 -2
  69. package/dist/data/refs.d.ts.map +1 -1
  70. package/dist/data/refs.js.map +1 -1
  71. package/dist/data/schemas.d.ts +3 -3
  72. package/dist/data/schemas.d.ts.map +1 -1
  73. package/dist/data/schemas.js.map +1 -1
  74. package/dist/data/sources.d.ts +6 -6
  75. package/dist/data/sources.d.ts.map +1 -1
  76. package/dist/data/sources.js.map +1 -1
  77. package/dist/data/values.d.ts +1 -1
  78. package/dist/data/values.d.ts.map +1 -1
  79. package/dist/data/values.js.map +1 -1
  80. package/dist/icon.js +1 -1
  81. package/dist/icon.js.map +1 -1
  82. package/dist/index.d.ts +24 -24
  83. package/dist/index.d.ts.map +1 -1
  84. package/dist/index.js +24 -24
  85. package/dist/index.js.map +1 -1
  86. package/dist/infra/isInfraAdapterDescriptor.d.ts +1 -1
  87. package/dist/infra/isInfraAdapterDescriptor.d.ts.map +1 -1
  88. package/dist/infra/isInfraAdapterDescriptor.js +2 -2
  89. package/dist/infra/isInfraAdapterDescriptor.js.map +1 -1
  90. package/dist/infra/isInfraAuthSpec.d.ts +1 -1
  91. package/dist/infra/isInfraAuthSpec.d.ts.map +1 -1
  92. package/dist/infra/isInfraAuthSpec.js +4 -4
  93. package/dist/infra/isInfraAuthSpec.js.map +1 -1
  94. package/dist/infra/isInfraCredentialRef.js +1 -1
  95. package/dist/infra/isInfraCredentialRef.js.map +1 -1
  96. package/dist/infra/isInfraDeploymentSpec.d.ts +1 -1
  97. package/dist/infra/isInfraDeploymentSpec.d.ts.map +1 -1
  98. package/dist/infra/isInfraDeploymentSpec.js +4 -4
  99. package/dist/infra/isInfraDeploymentSpec.js.map +1 -1
  100. package/dist/infra/isInfraEnvironmentSpec.d.ts +1 -1
  101. package/dist/infra/isInfraEnvironmentSpec.d.ts.map +1 -1
  102. package/dist/infra/isInfraEnvironmentSpec.js +8 -8
  103. package/dist/infra/isInfraEnvironmentSpec.js.map +1 -1
  104. package/dist/infra/isInfraManifest.d.ts +1 -1
  105. package/dist/infra/isInfraManifest.d.ts.map +1 -1
  106. package/dist/infra/isInfraManifest.js +5 -5
  107. package/dist/infra/isInfraManifest.js.map +1 -1
  108. package/dist/infra/isInfraWorkloadHealth.js +2 -2
  109. package/dist/infra/isInfraWorkloadHealth.js.map +1 -1
  110. package/dist/infra/isInfraWorkloadSpec.d.ts +1 -1
  111. package/dist/infra/isInfraWorkloadSpec.d.ts.map +1 -1
  112. package/dist/infra/isInfraWorkloadSpec.js +5 -5
  113. package/dist/infra/isInfraWorkloadSpec.js.map +1 -1
  114. package/dist/infra/isInfraWorkloadValue.js +3 -3
  115. package/dist/infra/isInfraWorkloadValue.js.map +1 -1
  116. package/dist/infra/parseInfraManifest.d.ts +2 -2
  117. package/dist/infra/parseInfraManifest.d.ts.map +1 -1
  118. package/dist/infra/parseInfraManifest.js +1 -1
  119. package/dist/infra/parseInfraManifest.js.map +1 -1
  120. package/dist/infra/validateInfraAdapterSelection.d.ts +3 -3
  121. package/dist/infra/validateInfraAdapterSelection.d.ts.map +1 -1
  122. package/dist/infra/validateInfraAdapterSelection.js +2 -2
  123. package/dist/infra/validateInfraAdapterSelection.js.map +1 -1
  124. package/dist/infra.d.ts +15 -15
  125. package/dist/infra.d.ts.map +1 -1
  126. package/dist/infra.js +9 -9
  127. package/dist/infra.js.map +1 -1
  128. package/dist/infraCatalog.d.ts +8 -8
  129. package/dist/infraCatalog.js +8 -8
  130. package/dist/infraCatalog.js.map +1 -1
  131. package/dist/media.d.ts +1 -1
  132. package/dist/media.d.ts.map +1 -1
  133. package/dist/media.js.map +1 -1
  134. package/dist/navigator/catalog.d.ts +3 -3
  135. package/dist/navigator/catalog.d.ts.map +1 -1
  136. package/dist/navigator/catalog.js.map +1 -1
  137. package/dist/navigator/extensions.d.ts +2 -2
  138. package/dist/navigator/extensions.d.ts.map +1 -1
  139. package/dist/navigator/extensions.js.map +1 -1
  140. package/dist/navigator/generation.d.ts +1 -1
  141. package/dist/navigator/generation.d.ts.map +1 -1
  142. package/dist/navigator/generation.js.map +1 -1
  143. package/dist/navigator/planning.d.ts +3 -3
  144. package/dist/navigator/planning.d.ts.map +1 -1
  145. package/dist/navigator/planning.js.map +1 -1
  146. package/dist/navigator.d.ts +7 -7
  147. package/dist/navigator.d.ts.map +1 -1
  148. package/dist/navigator.js +1 -1
  149. package/dist/navigator.js.map +1 -1
  150. package/dist/requirements.d.ts +1 -1
  151. package/dist/requirements.d.ts.map +1 -1
  152. package/dist/requirements.js.map +1 -1
  153. package/dist/runtimeCallbacks.d.ts +1 -1
  154. package/dist/runtimeCallbacks.d.ts.map +1 -1
  155. package/dist/runtimeCallbacks.js.map +1 -1
  156. package/dist/state.d.ts +1 -1
  157. package/dist/state.d.ts.map +1 -1
  158. package/dist/state.js.map +1 -1
  159. package/dist/structure/generated.d.ts +2 -2
  160. package/dist/structure/generated.js +2 -2
  161. package/dist/structure/generated.js.map +1 -1
  162. package/dist/structure/index.d.ts +1 -1
  163. package/dist/structure/index.d.ts.map +1 -1
  164. package/dist/structure/index.js.map +1 -1
  165. package/dist/structure/isStructureDescriptor.d.ts +1 -1
  166. package/dist/structure/isStructureDescriptor.d.ts.map +1 -1
  167. package/dist/structure/isStructureDescriptor.js.map +1 -1
  168. package/dist/structure/types.d.ts +1 -1
  169. package/dist/structure/types.d.ts.map +1 -1
  170. package/dist/structure/types.js.map +1 -1
  171. package/dist/theme.d.ts +1 -1
  172. package/dist/theme.d.ts.map +1 -1
  173. package/dist/theme.js.map +1 -1
  174. package/dist/types/appManifest.d.ts +1 -1
  175. package/dist/types/appManifest.d.ts.map +1 -1
  176. package/dist/types/appManifest.js.map +1 -1
  177. package/dist/types/infraAdapters.d.ts +7 -7
  178. package/dist/types/infraAdapters.d.ts.map +1 -1
  179. package/dist/types/infraAdapters.js.map +1 -1
  180. package/dist/types/infraLifecycle.d.ts +4 -4
  181. package/dist/types/infraLifecycle.d.ts.map +1 -1
  182. package/dist/types/infraLifecycle.js.map +1 -1
  183. package/dist/types/infraManifest.d.ts +8 -8
  184. package/dist/types/infraManifest.d.ts.map +1 -1
  185. package/dist/types/infraManifest.js.map +1 -1
  186. package/dist/types/infraSecrets.d.ts +1 -1
  187. package/dist/types/infraSecrets.d.ts.map +1 -1
  188. package/dist/types/infraSecrets.js.map +1 -1
  189. package/dist/types/infraTargets.d.ts +1 -1
  190. package/dist/types/infraTargets.d.ts.map +1 -1
  191. package/dist/types/infraTargets.js.map +1 -1
  192. package/dist/types/infraWorkload.d.ts +2 -2
  193. package/dist/types/infraWorkload.d.ts.map +1 -1
  194. package/dist/types/infraWorkload.js.map +1 -1
  195. package/dist/types.d.ts +13 -13
  196. package/dist/types.d.ts.map +1 -1
  197. package/dist/types.js.map +1 -1
  198. package/dist/ui.d.ts +2 -2
  199. package/dist/ui.d.ts.map +1 -1
  200. package/dist/ui.js.map +1 -1
  201. package/package.json +4 -4
  202. package/src/appManifest/bindings.ts +1 -1
  203. package/src/appManifest/constants.ts +1 -1
  204. package/src/appManifest/dataSources.ts +2 -2
  205. package/src/appManifest/isAppManifest.ts +9 -9
  206. package/src/appManifest/isAppStateSpec.ts +1 -1
  207. package/src/appManifest/isManifestValue.ts +1 -1
  208. package/src/appManifest/media.ts +1 -1
  209. package/src/appManifest/navigator.ts +3 -3
  210. package/src/appManifest/navigatorOptions.ts +1 -1
  211. package/src/appManifest/parseAppManifest.ts +2 -2
  212. package/src/appManifest/screens.ts +6 -6
  213. package/src/appManifest.ts +4 -4
  214. package/src/auth.ts +6 -6
  215. package/src/bindings.ts +3 -3
  216. package/src/cli/index.ts +1 -1
  217. package/src/data/apis.ts +6 -6
  218. package/src/data/diagnostics.ts +1 -1
  219. package/src/data/endpoints.ts +5 -5
  220. package/src/data/index.ts +10 -10
  221. package/src/data/isApiDefinitionRegistry.ts +3 -3
  222. package/src/data/operations.ts +5 -5
  223. package/src/data/refs.ts +2 -2
  224. package/src/data/schemas.ts +3 -3
  225. package/src/data/sources.ts +6 -6
  226. package/src/data/values.ts +1 -1
  227. package/src/icon.ts +1 -1
  228. package/src/index.ts +24 -24
  229. package/src/infra/isInfraAdapterDescriptor.ts +3 -3
  230. package/src/infra/isInfraAuthSpec.ts +6 -6
  231. package/src/infra/isInfraCredentialRef.ts +1 -1
  232. package/src/infra/isInfraDeploymentSpec.ts +6 -6
  233. package/src/infra/isInfraEnvironmentSpec.ts +10 -10
  234. package/src/infra/isInfraManifest.ts +7 -7
  235. package/src/infra/isInfraWorkloadHealth.ts +2 -2
  236. package/src/infra/isInfraWorkloadSpec.ts +7 -7
  237. package/src/infra/isInfraWorkloadValue.ts +4 -4
  238. package/src/infra/parseInfraManifest.ts +3 -3
  239. package/src/infra/validateInfraAdapterSelection.ts +5 -5
  240. package/src/infra.test.ts +1 -1
  241. package/src/infra.ts +15 -15
  242. package/src/infraCatalog.ts +8 -8
  243. package/src/infraPackedConsumer.test.ts +102 -0
  244. package/src/media.ts +1 -1
  245. package/src/navigator/catalog.ts +3 -3
  246. package/src/navigator/extensions.ts +2 -2
  247. package/src/navigator/generation.ts +1 -1
  248. package/src/navigator/planning.ts +3 -3
  249. package/src/navigator.ts +7 -7
  250. package/src/requirements.ts +1 -1
  251. package/src/runtimeCallbacks.ts +1 -1
  252. package/src/state.ts +1 -1
  253. package/src/structure/generated.ts +2 -2
  254. package/src/structure/index.ts +1 -1
  255. package/src/structure/isStructureDescriptor.ts +1 -1
  256. package/src/structure/types.ts +1 -1
  257. package/src/theme.ts +1 -1
  258. package/src/types/appManifest.ts +1 -1
  259. package/src/types/infraAdapters.ts +7 -7
  260. package/src/types/infraLifecycle.ts +4 -4
  261. package/src/types/infraManifest.ts +8 -8
  262. package/src/types/infraSecrets.ts +1 -1
  263. package/src/types/infraTargets.ts +1 -1
  264. package/src/types/infraWorkload.ts +2 -2
  265. package/src/types.ts +13 -13
  266. package/src/ui.ts +2 -2
@@ -1,21 +1,21 @@
1
1
  import { isRecord } from '@ankhorage/utility/object';
2
2
  import { isNonEmptyString } from '@ankhorage/utility/string';
3
3
 
4
- import { isSerializableSet } from '../collections';
5
- import { INFRA_ADAPTER_CATALOG } from '../infraCatalog';
4
+ import { isSerializableSet } from '../collections.js';
5
+ import { INFRA_ADAPTER_CATALOG } from '../infraCatalog.js';
6
6
  import type {
7
7
  InfraEnvironmentSpec,
8
8
  InfraObjectStorageSpec,
9
9
  InfraS3PersistenceTarget,
10
10
  InfraScheduledDatabaseBackupSpec,
11
- } from '../types/infraManifest';
12
- import type { InfraShape } from '../types/infraValidation';
13
- import { infraFields } from './infraFields';
14
- import { isInfraAuthSpec } from './isInfraAuthSpec';
15
- import { isInfraCredentialRef } from './isInfraCredentialRef';
16
- import { isInfraDeploymentSpec } from './isInfraDeploymentSpec';
17
- import { isInfraShape } from './isInfraShape';
18
- import { isInfraWorkloadSpec } from './isInfraWorkloadSpec';
11
+ } from '../types/infraManifest.js';
12
+ import type { InfraShape } from '../types/infraValidation.js';
13
+ import { infraFields } from './infraFields.js';
14
+ import { isInfraAuthSpec } from './isInfraAuthSpec.js';
15
+ import { isInfraCredentialRef } from './isInfraCredentialRef.js';
16
+ import { isInfraDeploymentSpec } from './isInfraDeploymentSpec.js';
17
+ import { isInfraShape } from './isInfraShape.js';
18
+ import { isInfraWorkloadSpec } from './isInfraWorkloadSpec.js';
19
19
 
20
20
  /*** Validate sibling capabilities and their required relationships within one environment. */
21
21
  export function isInfraEnvironmentSpec(value: unknown): value is InfraEnvironmentSpec {
@@ -1,12 +1,12 @@
1
1
  import { isRecord } from '@ankhorage/utility/object';
2
2
 
3
- import { isApiDefinitionRegistry } from '../data/isApiDefinitionRegistry';
4
- import { APP_ENVIRONMENT_IDS } from '../environments';
5
- import { isSerializableValue } from '../serializable';
6
- import type { InfraManifest, InfraModuleSpec } from '../types/infraManifest';
7
- import type { InfraShape } from '../types/infraValidation';
8
- import { isInfraEnvironmentSpec } from './isInfraEnvironmentSpec';
9
- import { isInfraShape } from './isInfraShape';
3
+ import { isApiDefinitionRegistry } from '../data/isApiDefinitionRegistry.js';
4
+ import { APP_ENVIRONMENT_IDS } from '../environments.js';
5
+ import { isSerializableValue } from '../serializable.js';
6
+ import type { InfraManifest, InfraModuleSpec } from '../types/infraManifest.js';
7
+ import type { InfraShape } from '../types/infraValidation.js';
8
+ import { isInfraEnvironmentSpec } from './isInfraEnvironmentSpec.js';
9
+ import { isInfraShape } from './isInfraShape.js';
10
10
 
11
11
  /*** Validate standalone infrastructure without AppManifest, Deploy or provider package side effects. */
12
12
  export function isInfraManifest(value: unknown): value is InfraManifest {
@@ -1,7 +1,7 @@
1
1
  import { isRecord } from '@ankhorage/utility/object';
2
2
 
3
- import { infraFields } from './infraFields';
4
- import { isInfraShape } from './isInfraShape';
3
+ import { infraFields } from './infraFields.js';
4
+ import { isInfraShape } from './isInfraShape.js';
5
5
 
6
6
  /*** Validate runtime-neutral readiness probes and bounded numeric parameters. */
7
7
  export function isInfraWorkloadHealth(value: unknown): boolean {
@@ -2,13 +2,13 @@ import { isStringArray } from '@ankhorage/utility/array';
2
2
  import { isRecord } from '@ankhorage/utility/object';
3
3
  import { isNonEmptyString } from '@ankhorage/utility/string';
4
4
 
5
- import { isSerializableSet } from '../collections';
6
- import type { InfraShape } from '../types/infraValidation';
7
- import type { InfraWorkloadSpec } from '../types/infraWorkload';
8
- import { infraFields } from './infraFields';
9
- import { isInfraShape } from './isInfraShape';
10
- import { isInfraWorkloadHealth } from './isInfraWorkloadHealth';
11
- import { isInfraWorkloadValue } from './isInfraWorkloadValue';
5
+ import { isSerializableSet } from '../collections.js';
6
+ import type { InfraShape } from '../types/infraValidation.js';
7
+ import type { InfraWorkloadSpec } from '../types/infraWorkload.js';
8
+ import { infraFields } from './infraFields.js';
9
+ import { isInfraShape } from './isInfraShape.js';
10
+ import { isInfraWorkloadHealth } from './isInfraWorkloadHealth.js';
11
+ import { isInfraWorkloadValue } from './isInfraWorkloadValue.js';
12
12
 
13
13
  /*** Validate the portable desired workload; runtime-specific fields and plaintext secret objects fail. */
14
14
  export function isInfraWorkloadSpec(value: unknown): value is InfraWorkloadSpec {
@@ -1,10 +1,10 @@
1
1
  import { isRecord } from '@ankhorage/utility/object';
2
2
  import { isNonEmptyString } from '@ankhorage/utility/string';
3
3
 
4
- import { APP_ENVIRONMENT_IDS } from '../environments';
5
- import type { InfraWorkloadScalarValue } from '../types/infraWorkload';
6
- import { isInfraCredentialRef } from './isInfraCredentialRef';
7
- import { isInfraShape } from './isInfraShape';
4
+ import { APP_ENVIRONMENT_IDS } from '../environments.js';
5
+ import type { InfraWorkloadScalarValue } from '../types/infraWorkload.js';
6
+ import { isInfraCredentialRef } from './isInfraCredentialRef.js';
7
+ import { isInfraShape } from './isInfraShape.js';
8
8
 
9
9
  /*** Workload values explicitly distinguish public literals, output dependencies and secret references. */
10
10
  export function isInfraWorkloadValue(value: unknown): boolean {
@@ -1,6 +1,6 @@
1
- import type { InfraResult } from '../types/infraLifecycle';
2
- import type { InfraManifest } from '../types/infraManifest';
3
- import { isInfraManifest } from './isInfraManifest';
1
+ import type { InfraResult } from '../types/infraLifecycle.js';
2
+ import type { InfraManifest } from '../types/infraManifest.js';
3
+ import { isInfraManifest } from './isInfraManifest.js';
4
4
 
5
5
  /** Parse unknown infrastructure input; package availability and credentials are separate validation stages. */
6
6
  export function parseInfraManifest(value: unknown): InfraResult<InfraManifest> {
@@ -1,8 +1,8 @@
1
- import { INFRA_ADAPTER_CATALOG } from '../infraCatalog';
2
- import type { InfraAdapterDescriptor } from '../types/infraAdapters';
3
- import type { InfraDiagnostic, InfraResult } from '../types/infraLifecycle';
4
- import type { InfraEnvironmentSpec } from '../types/infraManifest';
5
- import { isInfraAdapterDescriptor } from './isInfraAdapterDescriptor';
1
+ import { INFRA_ADAPTER_CATALOG } from '../infraCatalog.js';
2
+ import type { InfraAdapterDescriptor } from '../types/infraAdapters.js';
3
+ import type { InfraDiagnostic, InfraResult } from '../types/infraLifecycle.js';
4
+ import type { InfraEnvironmentSpec } from '../types/infraManifest.js';
5
+ import { isInfraAdapterDescriptor } from './isInfraAdapterDescriptor.js';
6
6
 
7
7
  /** Validate supplied installed descriptors without imports or filesystem access; only selected packages matter. */
8
8
  export function validateInfraAdapterSelection(
package/src/infra.test.ts CHANGED
@@ -250,7 +250,7 @@ describe('adapter package discovery contracts', () => {
250
250
  ).toBe(true);
251
251
  const result = validateInfraAdapterSelection(local, [INFRA_ADAPTER_CATALOG.local]);
252
252
  expect(result.ok).toBe(false);
253
- expect(result.diagnostics[0]?.message).toContain('@ankhorage/minikube');
253
+ expect(result.diagnostics[0]?.message).toContain('@ankhorage/infra-minikube');
254
254
  expect(result.diagnostics[0]?.code).toBe('adapter_unavailable');
255
255
  });
256
256
 
package/src/infra.ts CHANGED
@@ -1,16 +1,16 @@
1
1
  /** Canonical standalone infrastructure contracts, catalog and side-effect-free validation. */
2
- export { isInfraAdapterDescriptor } from './infra/isInfraAdapterDescriptor';
3
- export { isInfraAuthSpec } from './infra/isInfraAuthSpec';
4
- export { isInfraDeploymentSpec } from './infra/isInfraDeploymentSpec';
5
- export { isInfraEnvironmentSpec } from './infra/isInfraEnvironmentSpec';
6
- export { isInfraManifest } from './infra/isInfraManifest';
7
- export { isInfraWorkloadSpec } from './infra/isInfraWorkloadSpec';
8
- export { parseInfraManifest } from './infra/parseInfraManifest';
9
- export { validateInfraAdapterSelection } from './infra/validateInfraAdapterSelection';
10
- export { INFRA_ADAPTER_CATALOG, INFRA_RUNTIME_COMPATIBILITY } from './infraCatalog';
11
- export type * from './types/infraAdapters';
12
- export type * from './types/infraLifecycle';
13
- export type * from './types/infraManifest';
14
- export type * from './types/infraSecrets';
15
- export type * from './types/infraTargets';
16
- export type * from './types/infraWorkload';
2
+ export { isInfraAdapterDescriptor } from './infra/isInfraAdapterDescriptor.js';
3
+ export { isInfraAuthSpec } from './infra/isInfraAuthSpec.js';
4
+ export { isInfraDeploymentSpec } from './infra/isInfraDeploymentSpec.js';
5
+ export { isInfraEnvironmentSpec } from './infra/isInfraEnvironmentSpec.js';
6
+ export { isInfraManifest } from './infra/isInfraManifest.js';
7
+ export { isInfraWorkloadSpec } from './infra/isInfraWorkloadSpec.js';
8
+ export { parseInfraManifest } from './infra/parseInfraManifest.js';
9
+ export { validateInfraAdapterSelection } from './infra/validateInfraAdapterSelection.js';
10
+ export { INFRA_ADAPTER_CATALOG, INFRA_RUNTIME_COMPATIBILITY } from './infraCatalog.js';
11
+ export type * from './types/infraAdapters.js';
12
+ export type * from './types/infraLifecycle.js';
13
+ export type * from './types/infraManifest.js';
14
+ export type * from './types/infraSecrets.js';
15
+ export type * from './types/infraTargets.js';
16
+ export type * from './types/infraWorkload.js';
@@ -9,7 +9,7 @@ export const INFRA_RUNTIME_COMPATIBILITY = {
9
9
  export const INFRA_ADAPTER_CATALOG = {
10
10
  local: {
11
11
  id: 'local',
12
- package: '@ankhorage/local',
12
+ package: '@ankhorage/infra-local',
13
13
  kind: 'compute',
14
14
  configVersion: 1,
15
15
  capabilities: ['compute'],
@@ -18,7 +18,7 @@ export const INFRA_ADAPTER_CATALOG = {
18
18
  },
19
19
  hetzner: {
20
20
  id: 'hetzner',
21
- package: '@ankhorage/hetzner',
21
+ package: '@ankhorage/infra-hetzner',
22
22
  kind: 'compute',
23
23
  configVersion: 1,
24
24
  capabilities: ['compute'],
@@ -27,7 +27,7 @@ export const INFRA_ADAPTER_CATALOG = {
27
27
  },
28
28
  minikube: {
29
29
  id: 'minikube',
30
- package: '@ankhorage/minikube',
30
+ package: '@ankhorage/infra-minikube',
31
31
  kind: 'runtime',
32
32
  configVersion: 1,
33
33
  capabilities: ['runtime', 'workloads', 'networking'],
@@ -36,7 +36,7 @@ export const INFRA_ADAPTER_CATALOG = {
36
36
  },
37
37
  k3s: {
38
38
  id: 'k3s',
39
- package: '@ankhorage/k3s',
39
+ package: '@ankhorage/infra-k3s',
40
40
  kind: 'runtime',
41
41
  configVersion: 1,
42
42
  capabilities: ['runtime', 'workloads', 'networking'],
@@ -45,7 +45,7 @@ export const INFRA_ADAPTER_CATALOG = {
45
45
  },
46
46
  'docker-compose': {
47
47
  id: 'docker-compose',
48
- package: '@ankhorage/docker-compose',
48
+ package: '@ankhorage/infra-docker-compose',
49
49
  kind: 'runtime',
50
50
  configVersion: 1,
51
51
  capabilities: ['runtime', 'workloads', 'networking'],
@@ -54,7 +54,7 @@ export const INFRA_ADAPTER_CATALOG = {
54
54
  },
55
55
  supabase: {
56
56
  id: 'supabase',
57
- package: '@ankhorage/supabase',
57
+ package: '@ankhorage/infra-supabase',
58
58
  kind: 'service',
59
59
  configVersion: 1,
60
60
  capabilities: ['database', 'auth', 'objectStorage'],
@@ -63,7 +63,7 @@ export const INFRA_ADAPTER_CATALOG = {
63
63
  },
64
64
  cerbos: {
65
65
  id: 'cerbos',
66
- package: '@ankhorage/cerbos',
66
+ package: '@ankhorage/infra-cerbos',
67
67
  kind: 'service',
68
68
  configVersion: 1,
69
69
  capabilities: ['authz'],
@@ -72,7 +72,7 @@ export const INFRA_ADAPTER_CATALOG = {
72
72
  },
73
73
  r2: {
74
74
  id: 'r2',
75
- package: '@ankhorage/r2',
75
+ package: '@ankhorage/infra-r2',
76
76
  kind: 'service',
77
77
  configVersion: 1,
78
78
  capabilities: ['objectStorage'],
@@ -0,0 +1,102 @@
1
+ import { mkdirSync, mkdtempSync, readdirSync, rmSync, writeFileSync } from 'node:fs';
2
+ import { tmpdir } from 'node:os';
3
+ import { join } from 'node:path';
4
+
5
+ import { describe, expect, it } from 'bun:test';
6
+
7
+ const packageRoot = process.cwd();
8
+ const temporaryCacheDirectory = join(tmpdir(), 'contracts-infra-consumer-cache');
9
+
10
+ const runCommand = (command: string[], cwd: string): string => {
11
+ const result = Bun.spawnSync(command, {
12
+ cwd,
13
+ env: {
14
+ ...process.env,
15
+ BUN_INSTALL_CACHE_DIR: temporaryCacheDirectory,
16
+ npm_config_cache: temporaryCacheDirectory,
17
+ },
18
+ });
19
+ const output = `${result.stdout.toString()}${result.stderr.toString()}`;
20
+
21
+ expect(result.exitCode, output).toBe(0);
22
+ return output;
23
+ };
24
+
25
+ const writeConsumerFiles = (consumerDirectory: string): void => {
26
+ writeFileSync(
27
+ join(consumerDirectory, 'consumer.mjs'),
28
+ [
29
+ "import { INFRA_ADAPTER_CATALOG, isInfraAdapterDescriptor } from '@ankhorage/contracts/infra';",
30
+ 'const descriptor = INFRA_ADAPTER_CATALOG.hetzner;',
31
+ "if (!isInfraAdapterDescriptor(descriptor) || descriptor.package !== '@ankhorage/infra-hetzner') {",
32
+ " throw new Error('published infra contract is unavailable');",
33
+ '}',
34
+ ].join('\n'),
35
+ );
36
+ writeFileSync(
37
+ join(consumerDirectory, 'consumer.ts'),
38
+ [
39
+ "import { INFRA_ADAPTER_CATALOG, isInfraAdapterDescriptor } from '@ankhorage/contracts/infra';",
40
+ 'const descriptor = INFRA_ADAPTER_CATALOG.hetzner;',
41
+ 'const isCanonicalDescriptor: boolean = isInfraAdapterDescriptor(descriptor);',
42
+ 'void isCanonicalDescriptor;',
43
+ ].join('\n'),
44
+ );
45
+ };
46
+
47
+ const packAndInstall = (consumerDirectory: string, packedDirectory: string): void => {
48
+ runCommand(['bun', 'run', 'build'], packageRoot);
49
+ runCommand(
50
+ ['npm', 'pack', '--ignore-scripts', '--pack-destination', packedDirectory],
51
+ packageRoot,
52
+ );
53
+
54
+ const archiveName = readdirSync(packedDirectory).find((entry) => entry.endsWith('.tgz'));
55
+ expect(archiveName).toBeDefined();
56
+ runCommand(
57
+ ['bun', 'add', '--ignore-scripts', join(packedDirectory, archiveName ?? 'missing.tgz')],
58
+ consumerDirectory,
59
+ );
60
+ };
61
+
62
+ const verifyConsumer = (consumerDirectory: string): void => {
63
+ runCommand(['node', 'consumer.mjs'], consumerDirectory);
64
+ runCommand(['bun', 'consumer.mjs'], consumerDirectory);
65
+ runCommand(
66
+ [
67
+ join(packageRoot, 'node_modules/.bin/tsc'),
68
+ '--noEmit',
69
+ '--module',
70
+ 'NodeNext',
71
+ '--moduleResolution',
72
+ 'NodeNext',
73
+ '--target',
74
+ 'ES2022',
75
+ '--skipLibCheck',
76
+ 'consumer.ts',
77
+ ],
78
+ consumerDirectory,
79
+ );
80
+ };
81
+
82
+ describe('packed infra consumer', () => {
83
+ it('supports native Node ESM, Bun, and public declarations', () => {
84
+ const temporaryDirectory = mkdtempSync(join(tmpdir(), 'contracts-infra-consumer-'));
85
+ const consumerDirectory = join(temporaryDirectory, 'package');
86
+ const packedDirectory = join(temporaryDirectory, 'packed');
87
+
88
+ try {
89
+ mkdirSync(consumerDirectory);
90
+ mkdirSync(packedDirectory);
91
+ writeFileSync(
92
+ join(consumerDirectory, 'package.json'),
93
+ JSON.stringify({ name: 'contracts-infra-consumer', private: true, type: 'module' }),
94
+ );
95
+ writeConsumerFiles(consumerDirectory);
96
+ packAndInstall(consumerDirectory, packedDirectory);
97
+ verifyConsumer(consumerDirectory);
98
+ } finally {
99
+ rmSync(temporaryDirectory, { force: true, recursive: true });
100
+ }
101
+ });
102
+ });
package/src/media.ts CHANGED
@@ -1,7 +1,7 @@
1
1
  import { isRecord } from '@ankhorage/utility/object';
2
2
  import { isNonEmptyString } from '@ankhorage/utility/string';
3
3
 
4
- import type { EntityRegistry } from './collections';
4
+ import type { EntityRegistry } from './collections.js';
5
5
 
6
6
  export const MEDIA_ASSET_KINDS = ['image', 'audio', 'video', 'font', 'file'] as const;
7
7
 
@@ -4,14 +4,14 @@ import type {
4
4
  NavigatorPreset,
5
5
  NavigatorType,
6
6
  StackPresentation,
7
- } from '../navigator';
8
- import type { NavigatorDependencyRequirement } from './generation';
7
+ } from '../navigator.js';
8
+ import type { NavigatorDependencyRequirement } from './generation.js';
9
9
  import type {
10
10
  NavigatorApiStability,
11
11
  NavigatorCapabilityId,
12
12
  NavigatorRuntimePlatform,
13
13
  NavigatorSupportStatus,
14
- } from './planning';
14
+ } from './planning.js';
15
15
 
16
16
  export type NavigatorVerificationKind =
17
17
  | 'structural'
@@ -1,5 +1,5 @@
1
- import type { CustomNavigatorNode } from '../navigator';
2
- import type { NavigatorApiStability, NavigatorRuntimePlatform } from './planning';
1
+ import type { CustomNavigatorNode } from '../navigator.js';
2
+ import type { NavigatorApiStability, NavigatorRuntimePlatform } from './planning.js';
3
3
  export interface CustomNavigatorConfigIssue {
4
4
  code: string;
5
5
  message: string;
@@ -3,7 +3,7 @@ import type {
3
3
  NavigatorDiagnostic,
4
4
  NavigatorPlan,
5
5
  NavigatorSupportStatus,
6
- } from './planning';
6
+ } from './planning.js';
7
7
 
8
8
  export interface NavigatorGeneratedFile {
9
9
  path: string;
@@ -5,9 +5,9 @@ import type {
5
5
  RouteDefinition,
6
6
  StackImplementation,
7
7
  StackScreenOptions,
8
- } from '../navigator';
9
- import type { CustomNavigatorRegistry } from './extensions';
10
- import type { NavigatorDependencyRequirement } from './generation';
8
+ } from '../navigator.js';
9
+ import type { CustomNavigatorRegistry } from './extensions.js';
10
+ import type { NavigatorDependencyRequirement } from './generation.js';
11
11
 
12
12
  export interface ResolvedHeadlessTabsPresentation {
13
13
  presentation: ResolvedTabsPresentation;
package/src/navigator.ts CHANGED
@@ -1,7 +1,7 @@
1
- import type { ValueMap } from './collections';
2
- import type { IconSpec, ManifestValue } from './types';
1
+ import type { ValueMap } from './collections.js';
2
+ import type { IconSpec, ManifestValue } from './types.js';
3
3
 
4
- export { isAppNavigatorManifest } from './appManifest/navigator';
4
+ export { isAppNavigatorManifest } from './appManifest/navigator.js';
5
5
 
6
6
  export const NAVIGATOR_TYPES = ['slot', 'stack', 'tabs', 'drawer', 'split-view', 'custom'] as const;
7
7
  export type NavigatorType = (typeof NAVIGATOR_TYPES)[number];
@@ -288,12 +288,12 @@ export type {
288
288
  NavigatorPresetDescriptor,
289
289
  NavigatorVerificationKind,
290
290
  NavigatorVerificationStatus,
291
- } from './navigator/catalog';
291
+ } from './navigator/catalog.js';
292
292
  export type {
293
293
  CustomNavigatorConfigIssue,
294
294
  CustomNavigatorRegistration,
295
295
  CustomNavigatorRegistry,
296
- } from './navigator/extensions';
296
+ } from './navigator/extensions.js';
297
297
  export type {
298
298
  NavigatorDependencyRequirement,
299
299
  NavigatorGeneratedFile,
@@ -301,7 +301,7 @@ export type {
301
301
  NavigatorGenerationOptions,
302
302
  NavigatorGenerationResult,
303
303
  NavigatorScreenModule,
304
- } from './navigator/generation';
304
+ } from './navigator/generation.js';
305
305
  export type {
306
306
  CreateNavigatorPlanOptions,
307
307
  ExpoRouterNavigatorModule,
@@ -321,4 +321,4 @@ export type {
321
321
  ResolvedTabsImplementation,
322
322
  ResolvedTabsPresentation,
323
323
  TabsNavigatorPlan,
324
- } from './navigator/planning';
324
+ } from './navigator/planning.js';
@@ -1,4 +1,4 @@
1
- import type { SerializableSet } from './collections';
1
+ import type { SerializableSet } from './collections.js';
2
2
 
3
3
  export const ANKHORAGE_PERMISSION_NAMES = [
4
4
  'camera',
@@ -1,4 +1,4 @@
1
- import type { UiNode } from './types';
1
+ import type { UiNode } from './types.js';
2
2
 
3
3
  export interface RuntimeResolveNodePropsArgs {
4
4
  readonly node: UiNode;
package/src/state.ts CHANGED
@@ -1,4 +1,4 @@
1
- import type { SerializableValue } from './serializable';
1
+ import type { SerializableValue } from './serializable.js';
2
2
 
3
3
  /** Legend currently implements in-memory state only; unsupported persistence cannot be selected. */
4
4
  export interface AppStateSpec {
@@ -2,12 +2,12 @@
2
2
  import type { StructureDescriptorDocument } from '@ankhorage/contracts/structure';
3
3
 
4
4
  export const STRUCTURE_DESCRIPTOR_COMPILER_VERSION = '6.0.3';
5
- export const STRUCTURE_DESCRIPTOR_FINGERPRINT = 'sha256:c7abc673ea569cda9eda89e3a0a7eb0b1a5ab7f8b505a98aa5a7322207d1e404';
5
+ export const STRUCTURE_DESCRIPTOR_FINGERPRINT = 'sha256:572919c21c8b8eae4e4fda0e464fbb6e64c448425b737be1de7f4a203d709a4a';
6
6
 
7
7
  export const STRUCTURE_DESCRIPTOR = {
8
8
  "protocolVersion": 1,
9
9
  "packageName": "@ankhorage/contracts",
10
- "packageVersion": "26.2.0",
10
+ "packageVersion": "26.2.2",
11
11
  "roots": {
12
12
  "auth-flow": "AuthFlowConfig",
13
13
  "auth-profile": "AuthProfileSpec",
@@ -1,4 +1,4 @@
1
- export type { EntityRegistry, SerializableSet, ValueMap } from '../collections';
1
+ export type { EntityRegistry, SerializableSet, ValueMap } from '../collections.js';
2
2
  export {
3
3
  STRUCTURE_DESCRIPTOR,
4
4
  STRUCTURE_DESCRIPTOR_COMPILER_VERSION,
@@ -1,7 +1,7 @@
1
1
  import { hasOnlyKeys, isRecord } from '@ankhorage/utility/object';
2
2
  import { isNonEmptyString } from '@ankhorage/utility/string';
3
3
 
4
- import type { StructureDescriptor, StructureLiteralValue, StructureScalarType } from './types';
4
+ import type { StructureDescriptor, StructureLiteralValue, StructureScalarType } from './types.js';
5
5
 
6
6
  /*** Validate one standalone structural descriptor without resolving external/local references. */
7
7
  export function isStructureDescriptor(value: unknown): value is StructureDescriptor {
@@ -1,4 +1,4 @@
1
- import type { EntityRegistry, ValueMap } from '../collections';
1
+ import type { EntityRegistry, ValueMap } from '../collections.js';
2
2
 
3
3
  export type StructureDescriptorId = string;
4
4
 
package/src/theme.ts CHANGED
@@ -1,4 +1,4 @@
1
- import type { ValueMap } from './collections';
1
+ import type { ValueMap } from './collections.js';
2
2
 
3
3
  /** Numeric token values authored at theme level. */
4
4
  export type ThemeNumericTokenOverrides = ValueMap<string, number>;
@@ -1,4 +1,4 @@
1
- import type { AppManifest } from '../types';
1
+ import type { AppManifest } from '../types.js';
2
2
 
3
3
  export type AppManifestParseResult =
4
4
  | { readonly ok: true; readonly manifest: AppManifest }
@@ -1,5 +1,5 @@
1
- import type { AppEnvironmentId } from '../environments';
2
- import type { INFRA_ADAPTER_CATALOG } from '../infraCatalog';
1
+ import type { AppEnvironmentId } from '../environments.js';
2
+ import type { INFRA_ADAPTER_CATALOG } from '../infraCatalog.js';
3
3
  import type {
4
4
  InfraDestroyRequest,
5
5
  InfraGeneratedArtifact,
@@ -9,7 +9,7 @@ import type {
9
9
  InfraPlanAction,
10
10
  InfraResourceStatus,
11
11
  InfraResult,
12
- } from './infraLifecycle';
12
+ } from './infraLifecycle.js';
13
13
  import type {
14
14
  InfraAdapterId,
15
15
  InfraComputeProviderId,
@@ -17,10 +17,10 @@ import type {
17
17
  InfraEnvironmentSpec,
18
18
  InfraRuntimeProviderId,
19
19
  InfraRuntimeSelection,
20
- } from './infraManifest';
21
- import type { InfraControlPlaneCredentialRef, InfraSecretReference } from './infraSecrets';
22
- import type { InfraComputeTarget } from './infraTargets';
23
- import type { InfraWorkloadSpec } from './infraWorkload';
20
+ } from './infraManifest.js';
21
+ import type { InfraControlPlaneCredentialRef, InfraSecretReference } from './infraSecrets.js';
22
+ import type { InfraComputeTarget } from './infraTargets.js';
23
+ import type { InfraWorkloadSpec } from './infraWorkload.js';
24
24
 
25
25
  /** Package exports must match this exact catalog entry; optional operations are advertised explicitly. */
26
26
  export type InfraAdapterDescriptor<P extends InfraAdapterId = InfraAdapterId> = {
@@ -1,7 +1,7 @@
1
- import type { AppEnvironmentId } from '../environments';
2
- import type { InfraAdapterId } from './infraManifest';
3
- import type { InfraSecretReference } from './infraSecrets';
4
- import type { InfraComputeTarget } from './infraTargets';
1
+ import type { AppEnvironmentId } from '../environments.js';
2
+ import type { InfraAdapterId } from './infraManifest.js';
3
+ import type { InfraSecretReference } from './infraSecrets.js';
4
+ import type { InfraComputeTarget } from './infraTargets.js';
5
5
 
6
6
  /** Identity must be verified before mutation; unowned resources must never be pruned. */
7
7
  export interface InfraResourceIdentity {
@@ -1,11 +1,11 @@
1
- import type { AuthFlowConfig, AuthOAuthConfig } from '../auth';
2
- import type { EntityRegistry, SerializableSet, ValueMap } from '../collections';
3
- import type { ApiDefinitionRegistry, DataContractValue } from '../data';
4
- import type { AppEnvironmentId } from '../environments';
5
- import type { INFRA_ADAPTER_CATALOG, INFRA_RUNTIME_COMPATIBILITY } from '../infraCatalog';
6
- import type { AuthProfileSpec, AuthScope, AuthSignInSpec, AuthSignUpSpec } from '../types';
7
- import type { InfraControlPlaneCredentialRef } from './infraSecrets';
8
- import type { InfraWorkloadRegistry } from './infraWorkload';
1
+ import type { AuthFlowConfig, AuthOAuthConfig } from '../auth.js';
2
+ import type { EntityRegistry, SerializableSet, ValueMap } from '../collections.js';
3
+ import type { ApiDefinitionRegistry, DataContractValue } from '../data/index.js';
4
+ import type { AppEnvironmentId } from '../environments.js';
5
+ import type { INFRA_ADAPTER_CATALOG, INFRA_RUNTIME_COMPATIBILITY } from '../infraCatalog.js';
6
+ import type { AuthProfileSpec, AuthScope, AuthSignInSpec, AuthSignUpSpec } from '../types.js';
7
+ import type { InfraControlPlaneCredentialRef } from './infraSecrets.js';
8
+ import type { InfraWorkloadRegistry } from './infraWorkload.js';
9
9
 
10
10
  export type InfraAdapterId = keyof typeof INFRA_ADAPTER_CATALOG;
11
11
  export type InfraCapability =
@@ -1,4 +1,4 @@
1
- import type { AppEnvironmentId } from '../environments';
1
+ import type { AppEnvironmentId } from '../environments.js';
2
2
 
3
3
  /** Bootstrap credentials cannot depend on the managed secret store being provisioned. */
4
4
  export interface InfraControlPlaneCredentialRef {
@@ -1,4 +1,4 @@
1
- import type { InfraControlPlaneCredentialRef } from './infraSecrets';
1
+ import type { InfraControlPlaneCredentialRef } from './infraSecrets.js';
2
2
 
3
3
  /** Portable runtime target state contains credential identity only, never resolved values. */
4
4
  export type InfraComputeTarget = {
@@ -1,5 +1,5 @@
1
- import type { EntityRegistry, SerializableSet, ValueMap } from '../collections';
2
- import type { InfraControlPlaneCredentialRef, InfraSecretReference } from './infraSecrets';
1
+ import type { EntityRegistry, SerializableSet, ValueMap } from '../collections.js';
2
+ import type { InfraControlPlaneCredentialRef, InfraSecretReference } from './infraSecrets.js';
3
3
 
4
4
  export interface InfraWorkloadArtifact {
5
5
  readonly kind: 'image';