@tailglow/cli 0.9.4 → 0.9.6

package/README.md

@@ -39,7 +39,7 @@ Field names are snake_case on the wire and kebab-case on the command line: `repe
 becomes `--repeat-window-minutes`. Object and array fields take JSON:
 
 ```bash
-tglow views create-join --project prj_x --joins '[{"view_id":"view_b","on":"user_id"}]'
+tglow views create --project prj_x --type join --base-view-id view_a --joins '[{"lookup_view_id":"view_b","alias":"b","base_field":"user_id","lookup_field":"id"}]'
 ```
 
 ## Credentials

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tailglow/cli",
-  "version": "0.9.4",
+  "version": "0.9.6",
   "type": "module",
   "description": "The Tailglow command line. Every command is generated from the Tailglow API reference, so the CLI and the documentation can never describe different APIs.",
   "bin": {

package/src/commands.generated.js

@@ -248,13 +248,13 @@ export const CLI_COMMANDS = [
     "query_params": [],
     "body_fields": [
       {
-        "name": "tgl_authoring_mode",
-        "type": "TglAuthoringMode",
+        "name": "ambiguity_handling",
+        "type": "AmbiguityHandlingMode",
         "required": false,
-        "description": "Project-wide authoring behavior. Aggressive chooses a defensible mapping; normal requests clarification for competing meanings. Defaults to aggressive. Existing scripts are unchanged. Optional.",
+        "description": "What new mappings do when the source data allows more than one defensible reading. decide picks the most defensible one; ask requests a hint from you instead. Defaults to decide. Existing scripts are unchanged. Optional.",
         "allowed_values": [
-          "normal",
-          "aggressive"
+          "decide",
+          "ask"
         ],
         "deprecated": null
       },
@@ -1804,7 +1804,7 @@ export const CLI_COMMANDS = [
       "sources:read"
     ],
     "notes": [
-      "Documents are returned exactly as they were sent, minus Tailglow's own reserved envelope.",
+      "Documents are returned as they were sent, minus Tailglow's own reserved envelope. A value sent in a JSON array or JSONL that is not an object comes back as `{\"value\": ...}`.",
       "Paging is forward-only. Pass `pagination.next_cursor` back as `after` to get the next page; no `prev_cursor` is issued, and `before` returns the first page.",
       "While the project's server is stopped this answers 409 `server_stopped`. Start the server and try again.",
       "`after` and `before` are mutually exclusive."
@@ -2013,7 +2013,7 @@ export const CLI_COMMANDS = [
     "command": "create",
     "operation_id": "createView",
     "summary": "Create View",
-    "description": "Create a view that transforms records from a collection or another view.",
+    "description": "Create a view: a transform over one collection or view, or a join of a base view with lookups.",
     "method": "POST",
     "path": "/v1/projects/:project_id/views",
     "alternate_paths": [],
@@ -2021,15 +2021,19 @@ export const CLI_COMMANDS = [
       "views:write"
     ],
     "notes": [
-      "A view reads from exactly one source: a collection, or another view to derive from.",
       "The output schema defines the fields the view produces. A transform is created alongside the view to populate them.",
       "Leaving the transform script empty queues it for generation instead of rejecting it, so a view can be created before its TGL is written.",
       "Backfilling existing records starts shortly after creation and runs in the background. The view reports its progress while it catches up.",
-      "A view reads from exactly one place: set `collection_id` to derive from raw ingested records, or `parent_view_id` to derive from another view. Setting both, or neither, is rejected.",
+      "A join's base view and lookup views must all be views in this project.",
+      "A join whose inputs lead back to the join itself, directly or through other views, is rejected.",
+      "A `transform` view reads from exactly one place: set `collection_id` to derive from raw ingested records, or `parent_view_id` to derive from another view. Setting both, or neither, is rejected, and so are `base_view_id` and `joins`.",
+      "A `join` view requires `base_view_id` and `joins` (one to ten clauses), and rejects `collection_id` and `parent_view_id`. Join a collection by creating a view over it first.",
+      "Each join clause's `alias` must be lowercase letters, digits and underscores, and start with a letter. It is how the clause's fields are addressed in the transform script.",
+      "A join enriches each record with each joined view's latest value, by record timestamp, at the time the record is processed. Records already produced are not revisited.",
       "There is no `source_id` on this endpoint. One source can hold many collections, and the collection is what owns the schema and the records a view transforms. List a source's collections with `GET /v1/projects/:project/collections?source_id=...` and pass the one you want.",
       "`output_schema` field names must be unique by name, cannot conflict on type, and cannot collide with a reserved query key such as `limit` or `cursor`.",
-      "`transform_script` cannot be whitespace-only. Supplying one activates the view's first transform immediately and skips automatic TGL generation.",
-      "Use `hint` for rules the generator cannot read off the field names: a formatting rule (\"display_name should be Name (Type)\"), a business threshold (\"classify as high above 500\"), or a disambiguation when a source field could map more than one way. Skip it for obvious mappings like renames and type conversions, which the generator already handles."
+      "`transform_script` cannot be whitespace-only. Supplying one skips automatic TGL generation; omit it entirely to have one generated.",
+      "Use `hint` for rules the generator cannot read off the field names: a formatting rule (\"display_name should be Name (Type)\"), a business threshold (\"classify as high above 500\"), or a disambiguation when an input field could map more than one way. Skip it for obvious mappings like renames and type conversions, which the generator already handles."
     ],
     "path_params": [
       {
@@ -2043,6 +2047,17 @@ export const CLI_COMMANDS = [
     ],
     "query_params": [],
     "body_fields": [
+      {
+        "name": "type",
+        "type": "ViewType",
+        "required": false,
+        "description": "How the view's records are produced: `transform` reads one collection or view through a script; `join` starts from a base view and attaches lookup rows. Fixed at creation. Optional. Defaults to `\"transform\"`.",
+        "allowed_values": [
+          "transform",
+          "join"
+        ],
+        "deprecated": null
+      },
       {
         "name": "name",
         "type": "string",
@@ -2166,89 +2181,19 @@ export const CLI_COMMANDS = [
         "allowed_values": [],
         "deprecated": null
       },
-      {
-        "name": "transform_script",
-        "type": "string",
-        "required": false,
-        "description": "TGL transform script. When set, the view skips automatic TGL generation. Optional. Minimum length: `1`. Maximum length: `65536`.",
-        "allowed_values": [],
-        "deprecated": null
-      },
-      {
-        "name": "transform_mode",
-        "type": "string",
-        "required": false,
-        "description": "Whether a new schema version that no existing transform covers gets a script generated for it, or waits for you to write one. Defaults to auto. Optional.",
-        "allowed_values": [
-          "auto",
-          "manual"
-        ],
-        "deprecated": null
-      }
-    ]
-  },
-  {
-    "resource": "views",
-    "command": "create-join",
-    "operation_id": "createJoinView",
-    "summary": "Create Join View",
-    "description": "Create a view that joins two existing views on a shared key.",
-    "method": "POST",
-    "path": "/v1/projects/:project_id/views/join",
-    "alternate_paths": [],
-    "scopes": [
-      "views:write"
-    ],
-    "notes": [
-      "Both sides must be views in this project. Join a collection by creating a view over it first.",
-      "The join key must exist in the output schema of both sides.",
-      "A join view rebuilds when either side produces new records, so it trails its inputs rather than updating in the same instant.",
-      "Records are enriched with each joined view's latest value, by record timestamp, at the time they are processed. Records already produced are not revisited.",
-      "Each join clause's `alias` must be lowercase letters, digits and underscores, and start with a letter. It is how the clause's fields are addressed in the transform script.",
-      "`transform_script` cannot be whitespace-only. Omit it entirely to have one generated.",
-      "Use `hint` for rules the generator cannot read off the field names: a formatting rule (\"display_name should be Name (Type)\"), a business threshold (\"classify as high above 500\"), or a disambiguation when an input field could map more than one way. Skip it for obvious mappings like renames and type conversions, which the generator already handles."
-    ],
-    "path_params": [
-      {
-        "name": "project_id",
-        "type": "string",
-        "required": true,
-        "description": "Unique identifier of the project.",
-        "allowed_values": [],
-        "deprecated": null
-      }
-    ],
-    "query_params": [],
-    "body_fields": [
-      {
-        "name": "name",
-        "type": "string",
-        "required": true,
-        "description": "Name shown for this join view. Minimum length: `1`. Maximum length: `128`.",
-        "allowed_values": [],
-        "deprecated": null
-      },
-      {
-        "name": "project_id",
-        "type": "string",
-        "required": false,
-        "description": "Project the join view belongs to. Optional.",
-        "allowed_values": [],
-        "deprecated": null
-      },
       {
         "name": "base_view_id",
         "type": "string",
-        "required": true,
-        "description": "View every output record starts from. Minimum length: `1`.",
+        "required": false,
+        "description": "View every output record of a join starts from. Optional. Minimum length: `1`.",
         "allowed_values": [],
         "deprecated": null
       },
       {
         "name": "joins",
         "type": "object[]",
-        "required": true,
-        "description": "Views joined onto the base view, each with its own match fields.",
+        "required": false,
+        "description": "Views joined onto the base view, each with its own match fields. Optional.",
         "allowed_values": [],
         "deprecated": null,
         "fields": [
@@ -2315,61 +2260,23 @@ export const CLI_COMMANDS = [
           }
         ]
       },
-      {
-        "name": "output_schema",
-        "type": "object[]",
-        "required": false,
-        "description": "Fields the join produces. Leave empty to have one inferred. Optional. Defaults to `[]`.",
-        "allowed_values": [],
-        "deprecated": null,
-        "fields": [
-          {
-            "name": "name",
-            "type": "string",
-            "required": true,
-            "description": "Field name as it appears on the view's records. Minimum length: `1`. Maximum length: `128`.",
-            "allowed_values": [],
-            "deprecated": null
-          },
-          {
-            "name": "type",
-            "type": "string",
-            "required": true,
-            "description": "Value type the field holds.",
-            "allowed_values": [
-              "string",
-              "number",
-              "boolean",
-              "date",
-              "array",
-              "null"
-            ],
-            "deprecated": null
-          },
-          {
-            "name": "description",
-            "type": "string",
-            "required": false,
-            "description": "What the field means. Used as guidance when a transform script is generated. Optional. Maximum length: `512`.",
-            "allowed_values": [],
-            "deprecated": null
-          }
-        ]
-      },
       {
         "name": "transform_script",
         "type": "string",
         "required": false,
-        "description": "TGL transform script. Omit to have one generated. Optional. Minimum length: `1`. Maximum length: `65536`.",
+        "description": "TGL transform script. When set, the view skips automatic TGL generation. Optional. Minimum length: `1`. Maximum length: `65536`.",
         "allowed_values": [],
         "deprecated": null
       },
       {
-        "name": "hint",
+        "name": "transform_mode",
         "type": "string",
         "required": false,
-        "description": "Instructions the generator cannot infer from field names alone, such as a formatting rule or a business threshold. Optional. Maximum length: `4096`.",
-        "allowed_values": [],
+        "description": "Whether a new schema version that no existing transform covers gets a script generated for it, or waits for you to write one. Defaults to auto. Optional.",
+        "allowed_values": [
+          "auto",
+          "manual"
+        ],
         "deprecated": null
       }
     ]
@@ -8338,6 +8245,17 @@ export const CLI_COMMANDS = [
         ],
         "deprecated": null
       },
+      {
+        "name": "timezone_display",
+        "type": "TimezoneDisplay",
+        "required": false,
+        "description": "How the user reads times in the dashboard and in emails: `local` in the time zone their browser reports, `utc` in UTC. Optional.",
+        "allowed_values": [
+          "local",
+          "utc"
+        ],
+        "deprecated": null
+      },
       {
         "name": "default_ai_model",
         "type": "AiChatSelection",