@datadog/apps-frontend 0.0.2 → 0.0.4

package/dist/src/inputs/types.d.ts

@@ -0,0 +1,50 @@
+/* Unless explicitly stated otherwise all files in this repository are licensed under the Apache-2.0.
+ * This product includes software developed at Datadog (https://www.datadoghq.com/).
+ * Copyright 2019-Present Datadog, Inc.
+ */
+
+import type { AnyContract, AnyField, AnySchema, ClaimedValues, FunctionField, FunctionInputs, HostFunctionContext, InferOf, ValueField } from '../embedding/types.js';
+import type { UnionToIntersection } from '../embedding/versioning.js';
+/**
+ * Anything a host supplies values for: one flat namespace of fields. An
+ * inputs definition satisfies this with the union of every version's fields,
+ * which is why a provider never sees the versions individually.
+ */
+export type AnyFieldsOwner = Readonly<{
+    fields: Readonly<Record<string, AnyField>>;
+}>;
+/**
+ * The one flat namespace covering a whole set of definitions: every field of
+ * every definition, and so of every version of each. Surfaces and definitions
+ * relate many-to-many, so a host provides a set rather than one definition and
+ * populates a single record for the lot -- learning neither how many
+ * definitions are behind it nor how many versions are behind those.
+ */
+export type MergedFieldsOwner<TDefinitions extends readonly AnyFieldsOwner[]> = Readonly<{
+    fields: Readonly<{
+        [TKey in keyof UnionToIntersection<TDefinitions[number]['fields']>]: UnionToIntersection<TDefinitions[number]['fields']>[TKey] extends AnyField ? UnionToIntersection<TDefinitions[number]['fields']>[TKey] : never;
+    }>;
+}>;
+/** The values a resolved claim on one inputs definition carries. */
+export type DatadogAppInputsHostValues<TSchema extends Readonly<{
+    latest: AnyContract;
+}>> = ClaimedValues<TSchema['latest']>;
+type HostImplementation<TField extends AnyField> = TField extends ValueField<infer TSchema> ? InferOf<TSchema> : TField extends FunctionField<infer TInputs, infer TResult> ? (inputs: FunctionInputs<TInputs>, context: HostFunctionContext) => InferOf<TResult> | Promise<InferOf<TResult>> : never;
+export type FieldsHostImplementation<TFields extends Record<string, AnyField>> = Readonly<{
+    [TKey in keyof TFields]: HostImplementation<TFields[TKey]>;
+}>;
+/**
+ * Every value a host must supply for one inputs definition, in one flat
+ * record: the latest version's own fields alongside the extra inputs older
+ * versions need, with nothing marking which is which.
+ */
+export type DatadogAppInputImplementations<TSchema extends AnyFieldsOwner> = FieldsHostImplementation<TSchema['fields']>;
+export type DatadogAppInputValueUpdates<TSchema extends AnyFieldsOwner> = Readonly<{
+    [TKey in keyof TSchema['fields'] as TSchema['fields'][TKey] extends ValueField<AnySchema> ? TKey : never]: TSchema['fields'][TKey] extends ValueField<infer TSchema2> ? InferOf<TSchema2> : never;
+}>;
+/**
+ * `update()`'s shape: unlike construction, a caller only names the value
+ * fields it wants to change, so every field is optional.
+ */
+export type DatadogAppInputPartialValueUpdates<TSchema extends AnyFieldsOwner> = Partial<DatadogAppInputValueUpdates<TSchema>>;
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@datadog/apps-frontend",
-    "version": "0.0.2",
+    "version": "0.0.4",
     "private": false,
     "description": "React inputs for Datadog Apps",
     "homepage": "https://datadoghq.com",
@@ -28,6 +28,14 @@
         "./embedding/react": {
             "types": "./dist/src/embedding/react/index.d.ts",
             "default": "./dist/src/embedding/react/index.js"
+        },
+        "./inputs/react": {
+            "types": "./dist/src/inputs/react/index.d.ts",
+            "default": "./dist/src/inputs/react/index.js"
+        },
+        "./inputs/schema": {
+            "types": "./dist/src/inputs/schemas/index.d.ts",
+            "default": "./dist/src/inputs/schemas/index.js"
         }
     },
     "publishConfig": {
@@ -43,6 +51,14 @@
             "./embedding/react": {
                 "types": "./dist/src/embedding/react/index.d.ts",
                 "default": "./dist/src/embedding/react/index.js"
+            },
+            "./inputs/react": {
+                "types": "./dist/src/inputs/react/index.d.ts",
+                "default": "./dist/src/inputs/react/index.js"
+            },
+            "./inputs/schema": {
+                "types": "./dist/src/inputs/schemas/index.d.ts",
+                "default": "./dist/src/inputs/schemas/index.js"
             }
         },
         "access": "public"
@@ -55,9 +71,11 @@
     },
     "dependencies": {
         "@standard-schema/spec": "1.1.0",
-        "penpal": "7.0.6"
+        "penpal": "7.0.6",
+        "zod": "4.3.6"
     },
     "devDependencies": {
+        "@fast-check/jest": "2.0.3",
         "@testing-library/react": "16.3.0",
         "@types/datadog": "workspace:*",
         "@types/node": "catalog:",
@@ -66,8 +84,7 @@
         "esbuild": "0.27.5",
         "react": "catalog:",
         "react-dom": "catalog:",
-        "typescript": "patch:typescript%40npm%3A6.0.2#~/.yarn/patches/typescript-npm-6.0.2-no-dts-errors.patch",
-        "zod": "4.3.6"
+        "typescript": "patch:typescript%40npm%3A6.0.2#~/.yarn/patches/typescript-npm-6.0.2-no-dts-errors.patch"
     },
     "peerDependencies": {
         "react": "^18.0.0 || ^19.0.0"