@mittwald/api-client 0.0.0-development-a638234-20260416 → 0.0.0-development-64a6f01-20260504

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.
@@ -78,6 +78,8 @@ const buildContainerApi = (baseClient) => ({
78
78
  callPullImageWebhookForService: new ApiCallAsyncResourceFactory(descriptors.containerCallPullImageWebhookForService, baseClient.container.callPullImageWebhookForService).getApiResource,
79
79
  /** List Registries belonging to a Project. */
80
80
  listRegistries: new ApiCallAsyncResourceFactory(descriptors.containerListRegistries, baseClient.container.listRegistries).getApiResource,
81
+ /** List Stacks belonging to a Project. */
82
+ listStacks: new ApiCallAsyncResourceFactory(descriptors.containerListStacks, baseClient.container.listStacks).getApiResource,
81
83
  /** Get a Stack. */
82
84
  getStack: new ApiCallAsyncResourceFactory(descriptors.containerGetStack, baseClient.container.getStack).getApiResource,
83
85
  /** Get a Registry. */
@@ -90,14 +92,16 @@ const buildContainerApi = (baseClient) => ({
90
92
  getServiceLogs: new ApiCallAsyncResourceFactory(descriptors.containerGetServiceLogs, baseClient.container.getServiceLogs).getApiResource,
91
93
  /** Get a Service belonging to a Stack. */
92
94
  getService: new ApiCallAsyncResourceFactory(descriptors.containerGetService, baseClient.container.getService).getApiResource,
95
+ /** Get a Container Template by ID. */
96
+ getTemplate: new ApiCallAsyncResourceFactory(descriptors.containerGetTemplate, baseClient.container.getTemplate).getApiResource,
93
97
  /** List Stacks belonging to the executing user. */
94
98
  listSelfStacks: new ApiCallAsyncResourceFactory(descriptors.containerListSelfStacks, baseClient.container.listSelfStacks).getApiResource,
95
99
  /** List Services belonging to a Project. */
96
100
  listServices: new ApiCallAsyncResourceFactory(descriptors.containerListServices, baseClient.container.listServices).getApiResource,
97
101
  /** List Volumes belonging to a Stack. */
98
102
  listStackVolumes: new ApiCallAsyncResourceFactory(descriptors.containerListStackVolumes, baseClient.container.listStackVolumes).getApiResource,
99
- /** List Stacks belonging to a Project. */
100
- listStacks: new ApiCallAsyncResourceFactory(descriptors.containerListStacks, baseClient.container.listStacks).getApiResource,
103
+ /** List Container Templates. */
104
+ listTemplates: new ApiCallAsyncResourceFactory(descriptors.containerListTemplates, baseClient.container.listTemplates).getApiResource,
101
105
  /** List Volumes belonging to a Project. */
102
106
  listVolumes: new ApiCallAsyncResourceFactory(descriptors.containerListVolumes, baseClient.container.listVolumes).getApiResource,
103
107
  });
@@ -302,6 +306,10 @@ const buildDomainApi = (baseClient) => ({
302
306
  sslGetCertificate: new ApiCallAsyncResourceFactory(descriptors.sslGetCertificate, baseClient.domain.sslGetCertificate).getApiResource,
303
307
  /** List Certificates belonging to a Project or an Ingress. */
304
308
  sslListCertificates: new ApiCallAsyncResourceFactory(descriptors.sslListCertificates, baseClient.domain.sslListCertificates).getApiResource,
309
+ /** Get a Contact-Verification. */
310
+ getContactVerification: new ApiCallAsyncResourceFactory(descriptors.domainGetContactVerification, baseClient.domain.getContactVerification).getApiResource,
311
+ /** List Contact-Verifications belonging to the executing user. */
312
+ listContactVerifications: new ApiCallAsyncResourceFactory(descriptors.domainListContactVerifications, baseClient.domain.listContactVerifications).getApiResource,
305
313
  });
306
314
  const buildFileApi = (baseClient) => ({
307
315
  /** Get a File's meta. */
@@ -138,10 +138,16 @@ export class MittwaldAPIV2Client extends ApiClientBase {
138
138
  listRegistries: this.requestFunctionFactory(descriptors.containerListRegistries),
139
139
  /** Create a Registry. */
140
140
  createRegistry: this.requestFunctionFactory(descriptors.containerCreateRegistry),
141
+ /** List Stacks belonging to a Project. */
142
+ listStacks: this.requestFunctionFactory(descriptors.containerListStacks),
143
+ /** Create a Stack. */
144
+ createStack: this.requestFunctionFactory(descriptors.containerCreateStack),
141
145
  /** Get a Stack. */
142
146
  getStack: this.requestFunctionFactory(descriptors.containerGetStack),
143
147
  /** Declaratively create, update or delete Services or Volumes belonging to a Stack. */
144
148
  declareStack: this.requestFunctionFactory(descriptors.containerDeclareStack),
149
+ /** Delete a Stack. */
150
+ deleteStack: this.requestFunctionFactory(descriptors.containerDeleteStack),
145
151
  /** Create, update or delete Services or Volumes belonging to a Stack. */
146
152
  updateStack: this.requestFunctionFactory(descriptors.containerUpdateStack),
147
153
  /** Get a Registry. */
@@ -160,14 +166,16 @@ export class MittwaldAPIV2Client extends ApiClientBase {
160
166
  getServiceLogs: this.requestFunctionFactory(descriptors.containerGetServiceLogs),
161
167
  /** Get a Service belonging to a Stack. */
162
168
  getService: this.requestFunctionFactory(descriptors.containerGetService),
169
+ /** Get a Container Template by ID. */
170
+ getTemplate: this.requestFunctionFactory(descriptors.containerGetTemplate),
163
171
  /** List Stacks belonging to the executing user. */
164
172
  listSelfStacks: this.requestFunctionFactory(descriptors.containerListSelfStacks),
165
173
  /** List Services belonging to a Project. */
166
174
  listServices: this.requestFunctionFactory(descriptors.containerListServices),
167
175
  /** List Volumes belonging to a Stack. */
168
176
  listStackVolumes: this.requestFunctionFactory(descriptors.containerListStackVolumes),
169
- /** List Stacks belonging to a Project. */
170
- listStacks: this.requestFunctionFactory(descriptors.containerListStacks),
177
+ /** List Container Templates. */
178
+ listTemplates: this.requestFunctionFactory(descriptors.containerListTemplates),
171
179
  /** List Volumes belonging to a Project. */
172
180
  listVolumes: this.requestFunctionFactory(descriptors.containerListVolumes),
173
181
  /** Pull image and recreate */
@@ -178,14 +186,14 @@ export class MittwaldAPIV2Client extends ApiClientBase {
178
186
  restartService: this.requestFunctionFactory(descriptors.containerRestartService),
179
187
  /** Create or rotate pull-image webhook token */
180
188
  rotatePullImageWebhookForService: this.requestFunctionFactory(descriptors.containerRotatePullImageWebhookForService),
189
+ /** Replace the description of a Stack. */
190
+ setStackDescription: this.requestFunctionFactory(descriptors.containerSetStackDescription),
181
191
  /** Set an update schedule for a Stack. */
182
192
  setStackUpdateSchedule: this.requestFunctionFactory(descriptors.containerSetStackUpdateSchedule),
183
193
  /** Start a stopped Service. */
184
194
  startService: this.requestFunctionFactory(descriptors.containerStartService),
185
195
  /** Stop a started Service. */
186
196
  stopService: this.requestFunctionFactory(descriptors.containerStopService),
187
- /** Validate a Registries' credentials. */
188
- validateRegistryCredentials: this.requestFunctionFactory(descriptors.containerValidateRegistryCredentials),
189
197
  };
190
198
  /** The contract API allows you to manage your contracts and orders */
191
199
  contract = {
@@ -637,6 +645,12 @@ export class MittwaldAPIV2Client extends ApiClientBase {
637
645
  sslListCertificates: this.requestFunctionFactory(descriptors.sslListCertificates),
638
646
  /** Update the certificate of a CertificateRequest. */
639
647
  sslSetCertificateRequestCertificate: this.requestFunctionFactory(descriptors.sslSetCertificateRequestCertificate),
648
+ /** Get a Contact-Verification. */
649
+ getContactVerification: this.requestFunctionFactory(descriptors.domainGetContactVerification),
650
+ /** List Contact-Verifications belonging to the executing user. */
651
+ listContactVerifications: this.requestFunctionFactory(descriptors.domainListContactVerifications),
652
+ /** Resends a Contact-Verification email. */
653
+ resendContactVerificationEmail: this.requestFunctionFactory(descriptors.domainResendContactVerificationEmail),
640
654
  };
641
655
  /** The mail API allows you to manage your mail accounts. */
642
656
  mail = {
@@ -358,6 +358,18 @@ export const containerCreateRegistry = {
358
358
  method: "POST",
359
359
  operationId: "container-create-registry",
360
360
  };
361
+ /** List Stacks belonging to a Project. */
362
+ export const containerListStacks = {
363
+ path: "/v2/projects/{projectId}/stacks",
364
+ method: "GET",
365
+ operationId: "container-list-stacks",
366
+ };
367
+ /** Create a Stack. */
368
+ export const containerCreateStack = {
369
+ path: "/v2/projects/{projectId}/stacks",
370
+ method: "POST",
371
+ operationId: "container-create-stack",
372
+ };
361
373
  /** Get a Stack. */
362
374
  export const containerGetStack = {
363
375
  path: "/v2/stacks/{stackId}",
@@ -370,6 +382,12 @@ export const containerDeclareStack = {
370
382
  method: "PUT",
371
383
  operationId: "container-declare-stack",
372
384
  };
385
+ /** Delete a Stack. */
386
+ export const containerDeleteStack = {
387
+ path: "/v2/stacks/{stackId}",
388
+ method: "DELETE",
389
+ operationId: "container-delete-stack",
390
+ };
373
391
  /** Create, update or delete Services or Volumes belonging to a Stack. */
374
392
  export const containerUpdateStack = {
375
393
  path: "/v2/stacks/{stackId}",
@@ -424,6 +442,12 @@ export const containerGetService = {
424
442
  method: "GET",
425
443
  operationId: "container-get-service",
426
444
  };
445
+ /** Get a Container Template by ID. */
446
+ export const containerGetTemplate = {
447
+ path: "/v2/container-templates/{templateId}",
448
+ method: "GET",
449
+ operationId: "container-get-template",
450
+ };
427
451
  /** List Stacks belonging to the executing user. */
428
452
  export const containerListSelfStacks = {
429
453
  path: "/v2/stacks",
@@ -442,11 +466,11 @@ export const containerListStackVolumes = {
442
466
  method: "GET",
443
467
  operationId: "container-list-stack-volumes",
444
468
  };
445
- /** List Stacks belonging to a Project. */
446
- export const containerListStacks = {
447
- path: "/v2/projects/{projectId}/stacks",
469
+ /** List Container Templates. */
470
+ export const containerListTemplates = {
471
+ path: "/v2/container-templates",
448
472
  method: "GET",
449
- operationId: "container-list-stacks",
473
+ operationId: "container-list-templates",
450
474
  };
451
475
  /** List Volumes belonging to a Project. */
452
476
  export const containerListVolumes = {
@@ -478,6 +502,12 @@ export const containerRotatePullImageWebhookForService = {
478
502
  method: "POST",
479
503
  operationId: "container-rotate-pull-image-webhook-for-service",
480
504
  };
505
+ /** Replace the description of a Stack. */
506
+ export const containerSetStackDescription = {
507
+ path: "/v2/stacks/{stackId}/description",
508
+ method: "PUT",
509
+ operationId: "container-set-stack-description",
510
+ };
481
511
  /** Set an update schedule for a Stack. */
482
512
  export const containerSetStackUpdateSchedule = {
483
513
  path: "/v2/stacks/{stackId}/update-schedule",
@@ -496,12 +526,6 @@ export const containerStopService = {
496
526
  method: "POST",
497
527
  operationId: "container-stop-service",
498
528
  };
499
- /** Validate a Registries' credentials. */
500
- export const containerValidateRegistryCredentials = {
501
- path: "/v2/registries/{registryId}/actions/validate-credentials",
502
- method: "POST",
503
- operationId: "container-validate-registry-credentials",
504
- };
505
529
  /** Schedule the Termination of a ContractItem. */
506
530
  export const contractTerminateContractItem = {
507
531
  path: "/v2/contracts/{contractId}/items/{contractItemId}/termination",
@@ -2800,3 +2824,21 @@ export const verificationVerifyCompany = {
2800
2824
  method: "POST",
2801
2825
  operationId: "verification-verify-company",
2802
2826
  };
2827
+ /** Get a Contact-Verification. */
2828
+ export const domainGetContactVerification = {
2829
+ path: "/v2/contact-verifications/{contactVerificationId}",
2830
+ method: "GET",
2831
+ operationId: "domain-get-contact-verification",
2832
+ };
2833
+ /** List Contact-Verifications belonging to the executing user. */
2834
+ export const domainListContactVerifications = {
2835
+ path: "/v2/contact-verifications",
2836
+ method: "GET",
2837
+ operationId: "domain-list-contact-verifications",
2838
+ };
2839
+ /** Resends a Contact-Verification email. */
2840
+ export const domainResendContactVerificationEmail = {
2841
+ path: "/v2/contact-verifications/{contactVerificationId}/actions/resend-contact-verification-email",
2842
+ method: "POST",
2843
+ operationId: "domain-resend-contact-verification-email",
2844
+ };
@@ -1 +1 @@
1
- export const MittwaldAPIClientVersion = '4.346.0';
1
+ export const MittwaldAPIClientVersion = '4.355.0';
@@ -530,6 +530,20 @@ declare const buildContainerApi: (baseClient: MittwaldAPIV2Client) => {
530
530
  page?: number | undefined;
531
531
  } | undefined;
532
532
  }) => import("@mittwald/react-use-promise").AsyncResource<import("./types.js").MittwaldAPIV2.Components.Schemas.ContainerRegistry[]>;
533
+ /** List Stacks belonging to a Project. */
534
+ listStacks: (conf: {
535
+ projectId: string;
536
+ headers?: {
537
+ [x: string]: (string | number | boolean) | (string | number | boolean)[] | undefined;
538
+ "x-access-token"?: string | undefined;
539
+ } | undefined;
540
+ queryParameters?: {
541
+ [x: string]: (string | number | boolean) | (string | number | boolean)[] | undefined;
542
+ limit?: number | undefined;
543
+ skip?: number | undefined;
544
+ page?: number | undefined;
545
+ } | undefined;
546
+ }) => import("@mittwald/react-use-promise").AsyncResource<import("./types.js").MittwaldAPIV2.Components.Schemas.ContainerStackResponse[]>;
533
547
  /** Get a Stack. */
534
548
  getStack: (conf: {
535
549
  stackId: string;
@@ -544,6 +558,7 @@ declare const buildContainerApi: (baseClient: MittwaldAPIV2Client) => {
544
558
  prefix: string;
545
559
  projectId: string;
546
560
  services?: import("./types.js").MittwaldAPIV2.Components.Schemas.ContainerServiceResponse[] | undefined;
561
+ templateId?: string | undefined;
547
562
  updateSchedule?: {
548
563
  cron: string;
549
564
  timezone?: string;
@@ -644,6 +659,44 @@ declare const buildContainerApi: (baseClient: MittwaldAPIV2Client) => {
644
659
  status: import("./types.js").MittwaldAPIV2.Components.Schemas.ContainerServiceStatus;
645
660
  statusSetAt: string;
646
661
  }>;
662
+ /** Get a Container Template by ID. */
663
+ getTemplate: (conf: {
664
+ templateId: string;
665
+ headers?: {
666
+ [x: string]: (string | number | boolean) | (string | number | boolean)[] | undefined;
667
+ } | undefined;
668
+ }) => import("@mittwald/react-use-promise").AsyncResource<{
669
+ categories: string[];
670
+ description: {
671
+ de: string;
672
+ en: string;
673
+ };
674
+ developer: string;
675
+ domains?: {
676
+ port: string;
677
+ service: string;
678
+ userInput: string;
679
+ }[] | undefined;
680
+ icon: string;
681
+ id: string;
682
+ license?: string | undefined;
683
+ manifestVersion: string;
684
+ name: string;
685
+ repository?: string | undefined;
686
+ tagline: {
687
+ de: string;
688
+ en: string;
689
+ };
690
+ userInputs?: {
691
+ dataSource?: string;
692
+ defaultValue?: string;
693
+ name: string;
694
+ required: boolean;
695
+ validationSchema?: string;
696
+ }[] | undefined;
697
+ version: string;
698
+ website?: string | undefined;
699
+ }>;
647
700
  /** List Stacks belonging to the executing user. */
648
701
  listSelfStacks: (conf?: {
649
702
  headers?: {
@@ -652,6 +705,7 @@ declare const buildContainerApi: (baseClient: MittwaldAPIV2Client) => {
652
705
  } | undefined;
653
706
  queryParameters?: {
654
707
  [x: string]: (string | number | boolean) | (string | number | boolean)[] | undefined;
708
+ searchTerm?: string | undefined;
655
709
  limit?: number | undefined;
656
710
  skip?: number | undefined;
657
711
  page?: number | undefined;
@@ -692,20 +746,20 @@ declare const buildContainerApi: (baseClient: MittwaldAPIV2Client) => {
692
746
  page?: number | undefined;
693
747
  } | undefined;
694
748
  }) => import("@mittwald/react-use-promise").AsyncResource<import("./types.js").MittwaldAPIV2.Components.Schemas.ContainerVolumeResponse[]>;
695
- /** List Stacks belonging to a Project. */
696
- listStacks: (conf: {
697
- projectId: string;
749
+ /** List Container Templates. */
750
+ listTemplates: (conf?: {
698
751
  headers?: {
699
752
  [x: string]: (string | number | boolean) | (string | number | boolean)[] | undefined;
700
- "x-access-token"?: string | undefined;
701
753
  } | undefined;
702
754
  queryParameters?: {
703
755
  [x: string]: (string | number | boolean) | (string | number | boolean)[] | undefined;
756
+ category?: string | undefined;
757
+ searchTerm?: string | undefined;
704
758
  limit?: number | undefined;
705
759
  skip?: number | undefined;
706
760
  page?: number | undefined;
707
761
  } | undefined;
708
- }) => import("@mittwald/react-use-promise").AsyncResource<import("./types.js").MittwaldAPIV2.Components.Schemas.ContainerStackResponse[]>;
762
+ } | null | undefined) => import("@mittwald/react-use-promise").AsyncResource<import("./types.js").MittwaldAPIV2.Components.Schemas.ContainerTemplate[]>;
709
763
  /** List Volumes belonging to a Project. */
710
764
  listVolumes: (conf: {
711
765
  projectId: string;
@@ -1260,6 +1314,7 @@ declare const buildMarketplaceApi: (baseClient: MittwaldAPIV2Client) => {
1260
1314
  contributorName: string;
1261
1315
  createdAt?: string | undefined;
1262
1316
  disabled: boolean;
1317
+ extensionDeletionDeadline?: string | undefined;
1263
1318
  extensionId: string;
1264
1319
  extensionName: string;
1265
1320
  extensionSubTitle?: import("./types.js").MittwaldAPIV2.Components.Schemas.MarketplaceSubTitle | undefined;
@@ -1285,6 +1340,7 @@ declare const buildMarketplaceApi: (baseClient: MittwaldAPIV2Client) => {
1285
1340
  blocked?: boolean | undefined;
1286
1341
  context?: import("./types.js").MittwaldAPIV2.Components.Schemas.MarketplaceContext | undefined;
1287
1342
  contributorId: string;
1343
+ deletionDeadline?: string | undefined;
1288
1344
  deprecation?: import("./types.js").MittwaldAPIV2.Components.Schemas.MarketplaceExtensionDeprecation | undefined;
1289
1345
  description?: string | undefined;
1290
1346
  detailedDescriptions?: import("./types.js").MittwaldAPIV2.Components.Schemas.MarketplaceDetailedDescriptions | undefined;
@@ -1296,6 +1352,7 @@ declare const buildMarketplaceApi: (baseClient: MittwaldAPIV2Client) => {
1296
1352
  } | undefined;
1297
1353
  functional: boolean;
1298
1354
  id: string;
1355
+ isDeletionScheduled?: boolean | undefined;
1299
1356
  logoRefId?: string | undefined;
1300
1357
  name: string;
1301
1358
  pricing?: import("./types.js").MittwaldAPIV2.Components.Schemas.MarketplaceMonthlyPricePlanStrategy | undefined;
@@ -1373,6 +1430,7 @@ declare const buildMarketplaceApi: (baseClient: MittwaldAPIV2Client) => {
1373
1430
  contributorName: string;
1374
1431
  createdAt?: string | undefined;
1375
1432
  disabled: boolean;
1433
+ extensionDeletionDeadline?: string | undefined;
1376
1434
  extensionId: string;
1377
1435
  extensionName: string;
1378
1436
  extensionSubTitle?: import("./types.js").MittwaldAPIV2.Components.Schemas.MarketplaceSubTitle | undefined;
@@ -1404,6 +1462,7 @@ declare const buildMarketplaceApi: (baseClient: MittwaldAPIV2Client) => {
1404
1462
  contributorName: string;
1405
1463
  createdAt?: string | undefined;
1406
1464
  disabled: boolean;
1465
+ extensionDeletionDeadline?: string | undefined;
1407
1466
  extensionId: string;
1408
1467
  extensionName: string;
1409
1468
  extensionSubTitle?: import("./types.js").MittwaldAPIV2.Components.Schemas.MarketplaceSubTitle | undefined;
@@ -1474,10 +1533,12 @@ declare const buildMarketplaceApi: (baseClient: MittwaldAPIV2Client) => {
1474
1533
  context?: import("./types.js").MittwaldAPIV2.Components.Schemas.MarketplaceContext | undefined;
1475
1534
  searchTerm?: string | undefined;
1476
1535
  includeDeprecated?: boolean | undefined;
1536
+ includeFree?: boolean | undefined;
1537
+ includeChargeable?: boolean | undefined;
1477
1538
  limit?: number | undefined;
1478
1539
  skip?: number | undefined;
1479
1540
  page?: number | undefined;
1480
- sort?: "name" | undefined;
1541
+ sort?: "name" | "pricing.priceInCents" | undefined;
1481
1542
  order?: "asc" | "desc" | undefined;
1482
1543
  } | undefined;
1483
1544
  } | null | undefined) => import("@mittwald/react-use-promise").AsyncResource<import("./types.js").MittwaldAPIV2.Components.Schemas.MarketplaceExtension[]>;
@@ -2293,6 +2354,30 @@ declare const buildDomainApi: (baseClient: MittwaldAPIV2Client) => {
2293
2354
  ingressId?: string | undefined;
2294
2355
  } | undefined;
2295
2356
  } | null | undefined) => import("@mittwald/react-use-promise").AsyncResource<import("./types.js").MittwaldAPIV2.Components.Schemas.SslCertificate[]>;
2357
+ /** Get a Contact-Verification. */
2358
+ getContactVerification: (conf: {
2359
+ contactVerificationId: string;
2360
+ headers?: {
2361
+ [x: string]: (string | number | boolean) | (string | number | boolean)[] | undefined;
2362
+ "x-access-token"?: string | undefined;
2363
+ } | undefined;
2364
+ }) => import("@mittwald/react-use-promise").AsyncResource<{
2365
+ id: string;
2366
+ status: import("./types.js").MittwaldAPIV2.Components.Schemas.DomainContactVerificationStatus;
2367
+ typeData: import("./types.js").MittwaldAPIV2.Components.Schemas.DomainContactVerificationAddressData | import("./types.js").MittwaldAPIV2.Components.Schemas.DomainContactVerificationEmailData | import("./types.js").MittwaldAPIV2.Components.Schemas.DomainContactVerificationNameData;
2368
+ }>;
2369
+ /** List Contact-Verifications belonging to the executing user. */
2370
+ listContactVerifications: (conf?: {
2371
+ headers?: {
2372
+ [x: string]: (string | number | boolean) | (string | number | boolean)[] | undefined;
2373
+ "x-access-token"?: string | undefined;
2374
+ } | undefined;
2375
+ queryParameters?: {
2376
+ [x: string]: (string | number | boolean) | (string | number | boolean)[] | undefined;
2377
+ value?: string | undefined;
2378
+ type?: import("./types.js").MittwaldAPIV2.Components.Schemas.DomainContactVerificationType | undefined;
2379
+ } | undefined;
2380
+ } | null | undefined) => import("@mittwald/react-use-promise").AsyncResource<import("./types.js").MittwaldAPIV2.Components.Schemas.DomainContactVerification[]>;
2296
2381
  };
2297
2382
  declare const buildFileApi: (baseClient: MittwaldAPIV2Client) => {
2298
2383
  /** Get a File's meta. */