@carthooks/arcubase-cli 0.1.7 → 0.1.9

package/src/tests/help.test.ts

@@ -11,89 +11,70 @@ const env = {
   ARCUBASE_TOKEN_EXPIRES_AT: '',
 }
 
-test('root help prints modules', async () => {
+test('admin root help exposes reset surface nouns only', async () => {
   const out = await executeCLI('admin', ['--help'], env as any, async () => new Response('{}'))
   assert.equal(out.kind, 'help')
-  assert.match(out.text, /app/)
+  assert.match(out.text, /\bapp\b/)
+  assert.match(out.text, /\btable\b/)
+  assert.match(out.text, /\baccess-rule\b/)
+  assert.match(out.text, /\bworkflow\b/)
+  assert.doesNotMatch(out.text, /\bentity\b/)
+  assert.doesNotMatch(out.text, /\bingress\b/)
 })
 
-test('root help does not require runtime env', async () => {
-  const out = await executeCLI('admin', ['--help'], undefined, async () => new Response('{}'))
+test('user root help exposes reset surface nouns only', async () => {
+  const out = await executeCLI('user', ['--help'], env as any, async () => new Response('{}'))
   assert.equal(out.kind, 'help')
-  assert.match(out.text, /modules:/)
+  assert.match(out.text, /\bentry\b/)
+  assert.match(out.text, /\btable\b/)
+  assert.match(out.text, /\brow\b/)
+  assert.match(out.text, /\bupload\b/)
+  assert.match(out.text, /\bprofile\b/)
+  assert.match(out.text, /\bworkflow\b/)
+  assert.doesNotMatch(out.text, /\bglobal-action\b/)
+  assert.doesNotMatch(out.text, /\bentity\b/)
 })
 
-test('module help prints create-entity command', async () => {
+test('admin module help lists reset app commands', async () => {
   const out = await executeCLI('admin', ['app', '--help'], env as any, async () => new Response('{}'))
   assert.equal(out.kind, 'help')
-  assert.match(out.text, /create-entity/)
-  assert.match(out.text, /inventory/)
+  assert.match(out.text, /list/)
+  assert.match(out.text, /get/)
+  assert.match(out.text, /create/)
+  assert.match(out.text, /update/)
+  assert.match(out.text, /delete/)
+  assert.doesNotMatch(out.text, /list-apps/)
+  assert.doesNotMatch(out.text, /create-entity/)
 })
 
-test('module help does not require runtime env', async () => {
-  const out = await executeCLI('user', ['rows', '--help'], undefined, async () => new Response('{}'))
-  assert.equal(out.kind, 'help')
-  assert.match(out.text, /delete-entity-row/)
-})
-
-test('command help prints normalized external endpoint', async () => {
-  const out = await executeCLI('admin', ['app-entity-share', 'get-app-entity-shares', '--help'], env as any, async () => new Response('{}'))
-  assert.equal(out.kind, 'help')
-  assert.match(out.text, /endpoint: \/apps\/:app_id\/entity-shares/)
-  assert.doesNotMatch(out.text, /endpoint: \/api\//)
-})
-
-test('command help does not require runtime env', async () => {
-  const out = await executeCLI('user', ['rows', 'delete-entity-row', '--help'], undefined, async () => new Response('{}'))
-  assert.equal(out.kind, 'help')
-  assert.match(out.text, /endpoint: \/entity\/:app_id\/:entity_id\/delete-item/)
-})
-
-test('command help prints runtime doc hints for request body commands', async () => {
-  const out = await executeCLI('user', ['rows', 'update-entity-row', '--help'], undefined, async () => new Response('{}'))
-  assert.equal(out.kind, 'help')
-  assert.match(out.text, /docs:/)
-  assert.match(out.text, /\/opt\/arcubase-sdk\/docs\/runtime-reference\/row-crud\.md/)
-  assert.match(out.text, /\/opt\/arcubase-sdk\/docs\/runtime-reference\/examples\/README\.md/)
-})
-
-test('command help prints query-file support', async () => {
-  const out = await executeCLI('user', ['rows', 'query-entity', '--help'], undefined, async () => new Response('{}'))
+test('user row help replaces workflow row commands', async () => {
+  const out = await executeCLI('user', ['row', 'query', '--help'], undefined, async () => new Response('{}'))
   assert.equal(out.kind, 'help')
+  assert.match(out.text, /body: .*--body-file or --body-json/)
   assert.match(out.text, /query flags: --query-file/)
+  assert.doesNotMatch(out.text, /workflow query-entity/)
+  assert.doesNotMatch(out.text, /--entity-id/)
 })
 
-test('command help without request body can still point to lifecycle and examples docs', async () => {
-  const out = await executeCLI('admin', ['entity', 'admin-get-entity-info', '--help'], undefined, async () => new Response('{}'))
-  assert.equal(out.kind, 'help')
-  assert.match(out.text, /\/opt\/arcubase-sdk\/docs\/runtime-reference\/table-lifecycle\.md/)
-  assert.match(out.text, /\/opt\/arcubase-sdk\/docs\/runtime-reference\/examples\/README\.md/)
-})
-
-test('app inventory help explains app discovery purpose', async () => {
-  const out = await executeCLI('admin', ['app', 'inventory', '--help'], undefined, async () => new Response('{}'))
+test('admin table update-schema help uses table nouns and body-json', async () => {
+  const out = await executeCLI('admin', ['table', 'update-schema', '--help'], undefined, async () => new Response('{}'))
   assert.equal(out.kind, 'help')
-  assert.match(out.text, /list all accessible apps and each app entity list/)
-  assert.match(out.text, /use this before asking the user for app_id/)
+  assert.match(out.text, /body: .*--body-file or --body-json/)
+  assert.match(out.text, /path flags: --app-id, --table-id/)
+  assert.doesNotMatch(out.text, /--entity-id/)
+  assert.doesNotMatch(out.text, /admin-save-entity/)
 })
 
-test('admin-save-entity help prints row-operation next step', async () => {
-  const out = await executeCLI('admin', ['entity', 'admin-save-entity', '--help'], undefined, async () => new Response('{}'))
-  assert.equal(out.kind, 'help')
-  assert.match(out.text, /switch to arcubase for row operations/)
-  assert.match(out.text, /arcubase rows insert-entity/)
-  assert.match(out.text, /arcubase rows query-entity/)
-})
+test('admin access-rule help gives update whitelist and assign-users body-json examples', async () => {
+  const update = await executeCLI('admin', ['access-rule', 'update', '--help'], undefined, async () => new Response('{}'))
+  assert.equal(update.kind, 'help')
+  assert.match(update.text, /--app-id/)
+  assert.match(update.text, /--table-id/)
+  assert.match(update.text, /--rule-id/)
+  assert.match(update.text, /"update":\["enabled"\]/)
 
-test('wrong admin workflow command points to arcubase row command', async () => {
-  await assert.rejects(
-    () => executeCLI('admin', ['workflow', 'insert-entity'], env as any, async () => new Response('{}')),
-    (error: any) => {
-      assert.equal(error.code, 'UNKNOWN_COMMAND')
-      assert.equal(error.details?.reason, 'workflow insert-entity is not a valid command group; use arcubase rows for row operations')
-      assert.equal(error.details?.hint, 'use: arcubase rows insert-entity')
-      assert.ok((error.details?.suggestions ?? []).includes('arcubase rows insert-entity'))
-      return true
-    }
-  )
+  const assign = await executeCLI('admin', ['access-rule', 'assign-users', '--help'], undefined, async () => new Response('{}'))
+  assert.equal(assign.kind, 'help')
+  assert.match(assign.text, /"update":\["user_scope"\]/)
+  assert.match(assign.text, /"options":\{"user_scope":\[/)
 })

package/src/tests/upload.test.ts

@@ -35,7 +35,7 @@ test('upload returns file field value array for row payloads', async () => {
     async (input, init) => {
       const url = String(input)
       calls.push({ url, method: init?.method })
-      if (url === 'https://arcubase.example.com/upload/token') {
+      if (url === 'https://arcubase.example.com/api/upload/token') {
         return new Response(
           JSON.stringify({
             data: {
@@ -62,7 +62,7 @@ test('upload returns file field value array for row payloads', async () => {
 
   assert.equal(result.kind, 'result')
   assert.deepEqual(calls, [
-    { url: 'https://arcubase.example.com/upload/token', method: 'POST' },
+    { url: 'https://arcubase.example.com/api/upload/token', method: 'POST' },
     { url: 'https://uploads.example.com', method: 'POST' },
   ])
   assert.deepEqual(result.data, [
@@ -89,7 +89,7 @@ test('upload supports s3-post-policy tokens', async () => {
     async (input, init) => {
       const url = String(input)
       calls.push({ url, method: init?.method })
-      if (url === 'https://arcubase.example.com/upload/token') {
+      if (url === 'https://arcubase.example.com/api/upload/token') {
         return new Response(
           JSON.stringify({
             data: {
@@ -118,7 +118,7 @@ test('upload supports s3-post-policy tokens', async () => {
 
   assert.equal(result.kind, 'result')
   assert.deepEqual(calls, [
-    { url: 'https://arcubase.example.com/upload/token', method: 'POST' },
+    { url: 'https://arcubase.example.com/api/upload/token', method: 'POST' },
     { url: 'https://uploads.example.com/private-bucket', method: 'POST' },
   ])
   assert.deepEqual(result.data, [

package/src/tests/zod_registry.test.ts

@@ -14,19 +14,6 @@ test('EntityQueryReqVO schema exists', () => {
   assert.ok(getBodySchema('EntityQueryReqVO'))
 })
 
-test('inline request type schema exists', () => {
-  assert.ok(getBodySchema('{ name: string }'))
-})
-
-test('intersection request type schema exists', () => {
-  assert.ok(getBodySchema('EntityImportReqVO & EntityImportActionVO'))
-})
-
-test('manual notification override schema exists', () => {
-  assert.ok(getBodySchema('EntityUpdateNotificationsReqVO'))
-  assert.equal(getUnsupportedBodySchemaReason('EntityUpdateNotificationsReqVO'), null)
-})
-
 test('unknown request type has no schema and no unsupported reason', () => {
   assert.equal(getBodySchema('DefinitelyMissingReqVO'), null)
   assert.equal(getUnsupportedBodySchemaReason('DefinitelyMissingReqVO'), null)

package/sdk-dist/docs/runtime-reference/app-discovery.md

@@ -1,68 +0,0 @@
-# App Discovery
-
-Arcubase is a headless app platform.
-
-Core concepts:
-
-- app: the top-level business container
-- entity: a table inside an app
-- row: a record inside an entity
-
-Hard rule:
-
-- every operation happens inside one app
-- find the target app before schema work or row work
-
-Do not ask the user for `app_id` unless:
-
-- there is no matching app
-- there are multiple matching apps and you cannot resolve the ambiguity
-
-Do not ask the user for `entity_id` when creating a new table.
-Entity ids are assigned by Arcubase.
-
-## First command
-
-Use the inventory command first:
-
-```bash
-arcubase-admin app inventory
-```
-
-It returns:
-
-- every accessible app
-- each app id and app name
-- each app entity list
-
-Use it to resolve:
-
-- which existing app matches the user's business name
-- whether the table already exists
-- whether the user is talking about the wrong app
-
-## Resolution order
-
-1. if the user gives an app name, run `arcubase-admin app inventory`
-2. match the app by name yourself
-3. if the match is unique, continue without asking for `app_id`
-4. if there is no match, ask which app to use
-5. if there are multiple matches, ask the user to choose by app name
-
-## Existing app flow
-
-If the app already exists:
-
-1. run `arcubase-admin app inventory`
-2. find the app id
-3. inspect the existing entity list
-4. decide whether to create a new entity or write rows into an existing entity
-
-## New app flow
-
-If the user clearly wants a brand-new app:
-
-1. create the app with `arcubase-admin app create-app-by-tenants`
-2. create the entity shell
-3. save the schema
-4. switch to `arcubase rows ...` for row operations