@carthooks/arcubase-cli 0.1.10 → 0.1.13

package/sdk-dist/docs/runtime-reference/examples/oms-01/README.md

@@ -52,18 +52,18 @@ This example rewrites them into generic names such as:
 
 - `app-overview.md`
 - `create-app.json`
-- `sales-order.create-entity.json`
-- `item-master.create-entity.json`
+- `sales-order.table create.json`
+- `item-master.table create.json`
 - `item-master.schema.json`
 - `goods-receipt.schema.json`
 - `stock-issue.schema.json`
 - `picking-list.schema.json`
 - `sales-order.schema.json`
 - `purchase-order.schema.json`
-- `goods-receipt.create-entity.json`
-- `stock-issue.create-entity.json`
-- `picking-list.create-entity.json`
-- `purchase-order.create-entity.json`
+- `goods-receipt.table create.json`
+- `stock-issue.table create.json`
+- `picking-list.table create.json`
+- `purchase-order.table create.json`
 - `sales-order.row.insert.json`
 - `sales-order.query.json`
 - `sales-order.selection.ids.json`
@@ -75,13 +75,13 @@ This example rewrites them into generic names such as:
 For every `*.schema.json` file:
 
 1. create the entity shell
-2. fetch the shell with `admin-get-entity-info`
+2. fetch the shell with `table get`
 3. replace:
    - `__APP_ID__`
    - `__ENTITY_ID__`
    - `__SCHEMA_VERSION__`
-4. save the schema with `admin-save-entity`
-5. probe rows with `query-entity`
+4. save the schema with `table update-schema`
+5. probe rows with `row query`
 
 These schema files are templates, not live shell exports.
 
@@ -109,47 +109,47 @@ Do not use `arcubase-admin` for row operations.
 Create the app:
 
 ```bash
-arcubase-admin app create-app-by-tenants --body-file create-app.json
+arcubase-admin app create --body-file create-app.json | --body-json <json-string>
 ```
 
 Create the shell:
 
 ```bash
-arcubase-admin app create-entity --id <app_id> --body-file sales-order.create-entity.json
-arcubase-admin app create-entity --id <app_id> --body-file item-master.create-entity.json
-arcubase-admin app create-entity --id <app_id> --body-file goods-receipt.create-entity.json
-arcubase-admin app create-entity --id <app_id> --body-file stock-issue.create-entity.json
-arcubase-admin app create-entity --id <app_id> --body-file picking-list.create-entity.json
-arcubase-admin app create-entity --id <app_id> --body-file purchase-order.create-entity.json
+arcubase-admin table create --app-id <app_id> --body-file sales-order.table create.json | --body-json <json-string>
+arcubase-admin table create --app-id <app_id> --body-file item-master.table create.json | --body-json <json-string>
+arcubase-admin table create --app-id <app_id> --body-file goods-receipt.table create.json | --body-json <json-string>
+arcubase-admin table create --app-id <app_id> --body-file stock-issue.table create.json | --body-json <json-string>
+arcubase-admin table create --app-id <app_id> --body-file picking-list.table create.json | --body-json <json-string>
+arcubase-admin table create --app-id <app_id> --body-file purchase-order.table create.json | --body-json <json-string>
 ```
 
 Fetch the shell:
 
 ```bash
-arcubase-admin entity admin-get-entity-info --app-id <app_id> --table-id <table_id>
+arcubase-admin table get --app-id <app_id> --table-id <table_id>
 ```
 
 Save the schema:
 
 ```bash
-arcubase-admin entity admin-save-entity --app-id <app_id> --table-id <table_id> --body-file sales-order.schema.json
-arcubase-admin entity admin-save-entity --app-id <app_id> --table-id <table_id> --body-file item-master.schema.json
-arcubase-admin entity admin-save-entity --app-id <app_id> --table-id <table_id> --body-file goods-receipt.schema.json
-arcubase-admin entity admin-save-entity --app-id <app_id> --table-id <table_id> --body-file stock-issue.schema.json
-arcubase-admin entity admin-save-entity --app-id <app_id> --table-id <table_id> --body-file picking-list.schema.json
-arcubase-admin entity admin-save-entity --app-id <app_id> --table-id <table_id> --body-file purchase-order.schema.json
+arcubase-admin table update-schema --app-id <app_id> --table-id <table_id> --body-file sales-order.schema.json | --body-json <json-string>
+arcubase-admin table update-schema --app-id <app_id> --table-id <table_id> --body-file item-master.schema.json | --body-json <json-string>
+arcubase-admin table update-schema --app-id <app_id> --table-id <table_id> --body-file goods-receipt.schema.json | --body-json <json-string>
+arcubase-admin table update-schema --app-id <app_id> --table-id <table_id> --body-file stock-issue.schema.json | --body-json <json-string>
+arcubase-admin table update-schema --app-id <app_id> --table-id <table_id> --body-file picking-list.schema.json | --body-json <json-string>
+arcubase-admin table update-schema --app-id <app_id> --table-id <table_id> --body-file purchase-order.schema.json | --body-json <json-string>
 ```
 
 Insert one row:
 
 ```bash
-arcubase row create --app-id <app_id> --table-id <table_id> --body-file sales-order.row.insert.json
+arcubase row create --app-id <app_id> --table-id <table_id> --body-file sales-order.row.insert.json | --body-json <json-string>
 ```
 
 Query rows:
 
 ```bash
-arcubase row query --app-id <app_id> --table-id <table_id> --body-file sales-order.query.json
+arcubase row query --app-id <app_id> --table-id <table_id> --body-file sales-order.query.json | --body-json <json-string>
 ```
 
 ## Placeholder rules
@@ -170,7 +170,7 @@ When you replace them, keep these fields as JSON numbers:
 - `id`
 - `schema_version`
 - relation `app_id`
-- relation `table_id`
+- relation `entity_id`
 
 Do not leave the replaced values as JSON strings.
 

package/sdk-dist/docs/runtime-reference/examples/oms-01/sales-order.row.insert.json

@@ -16,7 +16,7 @@
       }
     ],
     "1008": "Taylor Morgan",
-    "1009": "+1-202-555-0102",
+    "1009": "+1-2188889847-555-0102",
     "1010": "10001",
     "1011": "120 Market Street",
     "1012": "Suite 8",

package/sdk-dist/docs/runtime-reference/examples/wms-01/README.md

@@ -1,21 +1,37 @@
 # WMS Example 01
 
-This directory is reserved for a generic warehouse and inventory example set.
+Warehouse and inventory example set.
 
-Planned tables:
+## Tables
 
 - `Item Master`
 - `Goods Receipt`
 - `Stock Issue`
-- `Stock Adjustment`
 - `Inventory Snapshot`
 
-Planned field patterns:
+## Files
 
-- `relation`
-- `query`
-- `number`
-- `status`
-- `datetime`
+- `create-app.json`
+- `item-master.create-entity.json`
+- `item-master.schema.json`
+- `goods-receipt.create-entity.json`
+- `goods-receipt.schema.json`
+- `stock-issue.create-entity.json`
+- `stock-issue.schema.json`
+- `inventory-snapshot.create-entity.json`
+- `inventory-snapshot.schema.json`
+- `inventory-snapshot.query.json`
+- `inventory-snapshot.bulk-update.json`
+- `inventory-snapshot.selection.condition.json`
 
-All names will remain generic and English-only.
+## Commands
+
+```bash
+arcubase-admin app create --body-file create-app.json | --body-json <json-string>
+arcubase-admin table create --app-id <app_id> --body-file item-master.create-entity.json | --body-json <json-string>
+arcubase-admin table get --app-id <app_id> --table-id <table_id>
+arcubase-admin table update-schema --app-id <app_id> --table-id <table_id> --body-file item-master.schema.json | --body-json <json-string>
+arcubase row query --app-id <app_id> --table-id <table_id> --body-file inventory-snapshot.query.json | --body-json <json-string>
+arcubase row bulk-update --app-id <app_id> --table-id <table_id> --body-file inventory-snapshot.bulk-update.json | --body-json <json-string>
+arcubase row selection-action --app-id <app_id> --table-id <table_id> --action archive --body-file inventory-snapshot.selection.condition.json | --body-json <json-string>
+```

package/sdk-dist/docs/runtime-reference/examples/wms-01/create-app.json

@@ -0,0 +1 @@
+{"name":"WMS Example 01"}

package/sdk-dist/docs/runtime-reference/examples/wms-01/goods-receipt.create-entity.json

@@ -0,0 +1 @@
+{"name":"Goods Receipt"}

package/sdk-dist/docs/runtime-reference/examples/wms-01/goods-receipt.schema.json

@@ -0,0 +1 @@
+{"id":"__TABLE_ID__","app_id":"__APP_ID__","name":"Goods Receipt","workflow_enabled":false,"fields":[{"id":1001,"label":"Receipt Number","type":"text","required":true,"unique":false,"editable":true,"visible":true,"show_label":true,"scannable":false,"default_value_mode":0,"description":"","value":null,"number_decimal":0,"depends":[],"key":"receipt_number","code_index":false,"options":{},"transfers":null,"children":null},{"id":1002,"label":"Quantity","type":"number","required":true,"unique":false,"editable":true,"visible":true,"show_label":true,"scannable":false,"default_value_mode":0,"description":"","value":null,"number_decimal":0,"depends":[],"key":"quantity","code_index":false,"options":{"mode":"number"},"transfers":null,"children":null}],"layout":[[1001],[1002]],"options":{},"schema_version":0,"field_id_seq":1003}

package/sdk-dist/docs/runtime-reference/examples/wms-01/inventory-snapshot.bulk-update.json

@@ -0,0 +1 @@
+{"selection":{"type":"condition","condition":{"field":":1002","operator":"gt","value":0}},"values":{":1002":100}}

package/sdk-dist/docs/runtime-reference/examples/wms-01/inventory-snapshot.create-entity.json

@@ -0,0 +1 @@
+{"name":"Inventory Snapshot"}

package/sdk-dist/docs/runtime-reference/examples/wms-01/inventory-snapshot.query.json

@@ -0,0 +1 @@
+{"limit":20,"offset":0,"search":{"text_search":"SKU-1001"},"sorts":[{"column":":1001","order":"desc"}]}

package/sdk-dist/docs/runtime-reference/examples/wms-01/inventory-snapshot.schema.json

@@ -0,0 +1 @@
+{"id":"__TABLE_ID__","app_id":"__APP_ID__","name":"Inventory Snapshot","workflow_enabled":false,"fields":[{"id":1001,"label":"Snapshot Date","type":"datetime","required":true,"unique":false,"editable":true,"visible":true,"show_label":true,"scannable":false,"default_value_mode":0,"description":"","value":null,"number_decimal":0,"depends":[],"key":"snapshot_date","code_index":false,"options":{"type":"date"},"transfers":null,"children":null},{"id":1002,"label":"On Hand Quantity","type":"number","required":true,"unique":false,"editable":true,"visible":true,"show_label":true,"scannable":false,"default_value_mode":0,"description":"","value":null,"number_decimal":0,"depends":[],"key":"on_hand_quantity","code_index":false,"options":{"mode":"number"},"transfers":null,"children":null}],"layout":[[1001],[1002]],"options":{},"schema_version":0,"field_id_seq":1003}

package/sdk-dist/docs/runtime-reference/examples/wms-01/inventory-snapshot.selection.condition.json

@@ -0,0 +1 @@
+{"selection":{"type":"condition","condition":{"field":":1002","operator":"lte","value":0}}}

package/sdk-dist/docs/runtime-reference/examples/wms-01/item-master.create-entity.json

@@ -0,0 +1 @@
+{"name":"Item Master"}

package/sdk-dist/docs/runtime-reference/examples/wms-01/item-master.schema.json

@@ -0,0 +1 @@
+{"id":"__TABLE_ID__","app_id":"__APP_ID__","name":"Item Master","workflow_enabled":false,"fields":[{"id":1001,"label":"SKU","type":"text","required":true,"unique":false,"editable":true,"visible":true,"show_label":true,"scannable":false,"default_value_mode":0,"description":"","value":null,"number_decimal":0,"depends":[],"key":"sku","code_index":false,"options":{},"transfers":null,"children":null},{"id":1002,"label":"Item Name","type":"text","required":true,"unique":false,"editable":true,"visible":true,"show_label":true,"scannable":false,"default_value_mode":0,"description":"","value":null,"number_decimal":0,"depends":[],"key":"item_name","code_index":false,"options":{},"transfers":null,"children":null}],"layout":[[1001],[1002]],"options":{},"schema_version":0,"field_id_seq":1003}

package/sdk-dist/docs/runtime-reference/examples/wms-01/stock-issue.create-entity.json

@@ -0,0 +1 @@
+{"name":"Stock Issue"}

package/sdk-dist/docs/runtime-reference/examples/wms-01/stock-issue.schema.json

@@ -0,0 +1 @@
+{"id":"__TABLE_ID__","app_id":"__APP_ID__","name":"Stock Issue","workflow_enabled":false,"fields":[{"id":1001,"label":"Issue Number","type":"text","required":true,"unique":false,"editable":true,"visible":true,"show_label":true,"scannable":false,"default_value_mode":0,"description":"","value":null,"number_decimal":0,"depends":[],"key":"issue_number","code_index":false,"options":{},"transfers":null,"children":null},{"id":1002,"label":"Issued At","type":"datetime","required":false,"unique":false,"editable":true,"visible":true,"show_label":true,"scannable":false,"default_value_mode":0,"description":"","value":null,"number_decimal":0,"depends":[],"key":"issued_at","code_index":false,"options":{"type":"date"},"transfers":null,"children":null}],"layout":[[1001],[1002]],"options":{},"schema_version":0,"field_id_seq":1003}

package/sdk-dist/docs/runtime-reference/row-crud.md

@@ -10,7 +10,7 @@ Command:
 arcubase row create \
   --app-id <app_id> \
   --table-id <table_id> \
-  --body-file insert.json
+  --body-file insert.json | --body-json <json-string>
 ```
 
 Minimal `insert.json`:
@@ -29,7 +29,9 @@ Rules:
 
 - use numeric field ids as JSON object keys
 - values must match the saved schema
-- if a field is `file` or `image`, run `arcubase upload <local-file>` first and use the returned `data` array as the field value
+- access policy is resolved internally from the visible app/table entry; do not add access policy fields to the JSON body
+- if the resolved access rule marks a field as not writable, the CLI fails with `FIELD_PERMISSION_REQUIRED`; remove that field or ask an admin to update the access rule
+- if a field is `file` or `image`, use the `upload token` flow in `uploads.md` and pass the returned upload value array
 
 Success result:
 
@@ -49,7 +51,7 @@ Command:
 arcubase row query \
   --app-id <app_id> \
   --table-id <table_id> \
-  --body-file query.json
+  --body-file query.json | --body-json <json-string>
 ```
 
 Minimal `query.json`:
@@ -66,6 +68,7 @@ Rules:
 - do not use `viewMode`
 - if you need the view selector, use `view_mode`
 - if you need archived view, also pass `--query-file`
+- access policy is resolved internally from the visible app/table entry; do not add access policy fields to the JSON body
 
 Typical row shape:
 
@@ -80,12 +83,18 @@ Typical row shape:
 }
 ```
 
+Returned values:
+
+- current row values are only in `fields`
+- fields absent from `fields` are not returned to the current user and have no row-value evidence
+- table schema `fields[].value` and `default_value_mode` describe schema defaults, not current row values
+
 ## Read one row
 
 Command:
 
 ```bash
-arcubase workflow get-entity-row \
+arcubase row get \
   --app-id <app_id> \
   --table-id <table_id> \
   --row-id <row_id>
@@ -93,6 +102,13 @@ arcubase workflow get-entity-row \
 
 Use this when you already know the row id and want the full record payload.
 
+Returned values:
+
+- current row values are in `record.fields`
+- fields absent from `record.fields` are not returned to the current user and have no row-value evidence
+- use `fieldPermits` only to explain access, not as current row values
+- read visibility status is `fieldPermits read:false`; `FIELD_PERMISSION_REQUIRED` is a write preflight error from row create/update
+
 ## Update a row
 
 Command:
@@ -102,7 +118,7 @@ arcubase row update \
   --app-id <app_id> \
   --table-id <table_id> \
   --row-id <row_id> \
-  --body-file update.json
+  --body-file update.json | --body-json <json-string>
 ```
 
 Minimal `update.json`:
@@ -122,7 +138,9 @@ Rules:
 - `changed_fields` is required
 - every id in `changed_fields` must also appear in `data`
 - use numeric field ids as JSON object keys
-- if a field is `file` or `image`, run `arcubase upload <local-file>` first and use the returned `data` array as the field value
+- access policy is resolved internally from the visible app/table entry; do not add access policy fields to the JSON body
+- if the resolved access rule marks a field as not writable, the CLI fails with `FIELD_PERMISSION_REQUIRED`; remove that field or ask an admin to update the access rule
+- if a field is `file` or `image`, use the `upload token` flow in `uploads.md` and pass the returned upload value array
 
 Success result:
 
@@ -142,7 +160,7 @@ Command:
 arcubase row delete \
   --app-id <app_id> \
   --table-id <table_id> \
-  --body-file delete.json
+  --body-file delete.json | --body-json <json-string>
 ```
 
 Minimal `delete.json`:
@@ -161,7 +179,29 @@ Rules:
 
 - use `selection.type = "ids"`
 - when `length` is provided, keep it equal to `ids.length`
+- access policy is resolved internally from the visible app/table entry; do not add access policy fields to the JSON body
 
 ## Restore rows
 
-`row restore` is not part of the reset CLI white list.
+Command:
+
+```bash
+arcubase row update \
+  --app-id <app_id> \
+  --table-id <table_id> \
+  --body-file restore.json | --body-json <json-string>
+```
+
+Minimal `restore.json`:
+
+```json
+{
+  "selection": {
+    "type": "ids",
+    "ids": [4000000046],
+    "length": 1
+  }
+}
+```
+
+The same `selection` rules apply as delete.

package/sdk-dist/docs/runtime-reference/search-and-bulk-actions.md

@@ -1,13 +1,16 @@
 # Search And Bulk Actions
 
+For exact selection and condition shapes, also read:
+
+- `selection.md`
+- `condition.md`
+
 Use this page for:
 
 - search
 - selection actions
 - archived queries
 - bulk update
-- selection tags
-- batch operator
 
 ## Main query command
 
@@ -17,7 +20,7 @@ Use:
 arcubase row query \
   --app-id <app_id> \
   --table-id <table_id> \
-  --body-file query.json
+  --body-file query.json | --body-json <json-string>
 ```
 
 For extra query-string parameters, also use:
@@ -77,7 +80,7 @@ Rules:
 
 Archived view requires both:
 
-- `--body-file archived-body.json`
+- `--body-file archived-body.json | --body-json <json-string>`
 - `--query-file archived-query.json`
 
 Command:
@@ -87,7 +90,7 @@ arcubase row query \
   --app-id <app_id> \
   --table-id <table_id> \
   --query-file archived-query.json \
-  --body-file archived-body.json
+  --body-file archived-body.json | --body-json <json-string>
 ```
 
 `archived-body.json`:
@@ -132,13 +135,14 @@ Selection fragment:
 Rules:
 
 - `length` should match `ids.length`
-- this is the safest path for delete, restore, tags, and targeted bulk actions
+- this is the safest path for delete, restore, and targeted bulk actions
 
 ## Selection with conditions
 
 Use this when the action should apply to the current filtered result set.
 
 This shape is **not** the same as `query.json.search`.
+This shape is **not** `ConditionSet`.
 
 Use route-query style keys inside `selection.condition`:
 
@@ -186,10 +190,27 @@ Rules:
 
 - `condition.selectAll` must be `true`
 - do not use `text_search` inside `selection.condition`
+- do not use `{mode, conditions}` inside `selection.condition`
+- do not use `{field, operator, value}` inside `selection.condition`
 - `filter_:...` values should be URL-encoded JSON strings
 - keep `length` equal to the intended matched count
 - include `sorts` when your selection came from a sorted list view
 
+## Selection tags
+
+Current reset surface has no tag-specific CLI command.
+
+Use one of the current single success paths instead:
+
+- `arcubase row selection-action` for query, archive, restore, and batch actions
+- `arcubase row bulk-update` for field updates across a selected set
+
+Rules:
+
+- tags are not a separate namespace in the reset surface
+- do not call a tag module directly
+- express the target rows through `selection`
+
 ## Query selected rows
 
 Command:
@@ -199,7 +220,7 @@ arcubase row selection-action \
   --app-id <app_id> \
   --table-id <table_id> \
   --action query \
-  --body-file query-selection.json
+  --body-file query-selection.json | --body-json <json-string>
 ```
 
 Working `query-selection.json` with ids:
@@ -239,7 +260,7 @@ arcubase row selection-action \
   --app-id <app_id> \
   --table-id <table_id> \
   --action archive \
-  --body-file archive-selection.json
+  --body-file archive-selection.json | --body-json <json-string>
 ```
 
 Rules:
@@ -257,14 +278,13 @@ arcubase row selection-action \
   --app-id <app_id> \
   --table-id <table_id> \
   --action batch_print \
-  --body-file batch-print-selection.json
+  --body-file batch-print-selection.json | --body-json <json-string>
 ```
 
 Working shape:
 
 ```json
 {
-  "policy_id": "",
   "selection": {
     "type": "ids",
     "ids": [4000000127],
@@ -283,7 +303,7 @@ Command:
 arcubase row bulk-update \
   --app-id <app_id> \
   --table-id <table_id> \
-  --body-file bulk-update.json
+  --body-file bulk-update.json | --body-json <json-string>
 ```
 
 Working `bulk-update.json` with ids:
@@ -377,87 +397,3 @@ Rules:
 - use `type: set` when you want to assign a new scalar value directly
 - for `type: set`, send the new value as `action.value`
 - do not use `type: value`
-
-## Selection tags
-
-These commands use `arcubase-admin`.
-
-Get tags:
-
-```bash
-arcubase-admin entity-tags get-selection-tags \
-  --appId <app_id> \
-  --entityId <table_id> \
-  --body-file get-tags.json
-```
-
-`get-tags.json`:
-
-```json
-{
-  "policy_id": "",
-  "selection": {
-    "type": "ids",
-    "ids": [4000000127],
-    "length": 1
-  }
-}
-```
-
-Add tags:
-
-```bash
-arcubase-admin entity-tags batch-add-entity-tags \
-  --appId <app_id> \
-  --entityId <table_id> \
-  --body-file add-tags.json
-```
-
-`add-tags.json`:
-
-```json
-{
-  "policy_id": "",
-  "selection": {
-    "type": "ids",
-    "ids": [4000000127],
-    "length": 1
-  },
-  "tag_names": ["tag-a", "tag-b"]
-}
-```
-
-Remove tags:
-
-```bash
-arcubase-admin entity-tags batch-remove-entity-tags \
-  --appId <app_id> \
-  --entityId <table_id> \
-  --body-file remove-tags.json
-```
-
-`remove-tags.json`:
-
-```json
-{
-  "policy_id": "",
-  "selection": {
-    "type": "ids",
-    "ids": [4000000127],
-    "length": 1
-  },
-  "tag_names": ["tag-a"]
-}
-```
-
-Rules:
-
-- for admin-mode local validation, `policy_id` can be `""`
-- these commands use the same `selection` rules as other selection actions
-- `tag_names` must be a non-empty string array
-
-## Invoke batch operator
-
-`invoke-batch-operator` is not part of the reset CLI white list.
-- `params` is optional and should be an object
-- if the entity has no matching custom action or event, the server returns an upstream error