@seliseblocks/cli-os 0.2.8 → 0.2.10

package/dist/commands/data/schema/get.js

@@ -1,5 +1,6 @@
 import { stringFlag } from "../../../lib/args.js";
 import { blocksRequest } from "../../../lib/api.js";
+import { isRecord } from "../../../lib/data-response.js";
 import { writeOutput } from "../../../lib/output.js";
 import { requestContext } from "../../../lib/request-context.js";
 import { parseCommand, selectedProject } from "../../../lib/workspace.js";
@@ -14,4 +15,34 @@ export async function dataSchemaGet(argv) {
         query: { id }
     });
     writeOutput(result, flags);
+    // --json stays machine-readable and unchanged; human runs also get the
+    // exact GraphQL operation names, since they are naive string concatenation
+    // (no English pluralization) rather than the pattern users tend to guess.
+    if (!flags.json) {
+        for (const line of graphqlOperationLines(result))
+            console.log(line);
+    }
+}
+function graphqlOperationLines(result) {
+    const data = isRecord(result) && isRecord(result.data) ? result.data : undefined;
+    if (!data)
+        return [];
+    const schemaName = typeof data.schemaName === "string" ? data.schemaName : undefined;
+    const querySchema = typeof data.querySchema === "string" ? data.querySchema : undefined;
+    const mutationSchemas = Array.isArray(data.mutationSchemas)
+        ? data.mutationSchemas.filter((item) => typeof item === "string")
+        : [];
+    if (!schemaName && !querySchema && mutationSchemas.length === 0)
+        return [];
+    const lines = ["", "GraphQL operation names (exact -- resolver names are not English-pluralized):"];
+    if (querySchema)
+        lines.push(`  Query:        get${querySchema}`);
+    for (const mutation of mutationSchemas)
+        lines.push(`  Mutation:     ${mutation}`);
+    if (schemaName) {
+        lines.push(`  Bulk insert:  insertMany${schemaName}`);
+        lines.push(`  Bulk update:  updateMany${schemaName}`);
+        lines.push(`  Bulk delete:  deleteMany${schemaName}`);
+    }
+    return lines;
 }

package/dist/commands/data/schema/list.js

@@ -1,15 +1,22 @@
+import { integerFlag } from "../../../lib/args.js";
 import { blocksRequest } from "../../../lib/api.js";
+import { unwrapSchemaListResponse } from "../../../lib/data-response.js";
 import { writeOutput } from "../../../lib/output.js";
 import { requestContext } from "../../../lib/request-context.js";
 import { parseCommand, selectedProject } from "../../../lib/workspace.js";
 export async function dataSchemaList(argv) {
     const { flags } = parseCommand(argv);
     const projectKey = await selectedProject(flags);
+    const pageNo = integerFlag(flags, "page", 1);
+    const pageSize = integerFlag(flags, "page-size", 100);
     const result = await blocksRequest("/data/v4/schemas", {
         impersonatedProjectAuth: true,
         ...requestContext(flags),
         projectTenantId: projectKey,
-        query: { PageNo: 1, PageSize: 100, ProjectKey: projectKey }
+        query: { PageNo: pageNo, PageSize: pageSize, ProjectKey: projectKey }
     });
+    // Throws on a malformed envelope so an unexpected response shape is never
+    // mistaken for an empty schema list.
+    unwrapSchemaListResponse(result);
     writeOutput(result, flags);
 }

package/dist/commands/data/schema/pull.js

@@ -1,20 +1,33 @@
 import { blocksRequest } from "../../../lib/api.js";
 import { writeOutput } from "../../../lib/output.js";
 import { requestContext } from "../../../lib/request-context.js";
-import { writeSchemaFile } from "../../../lib/data-files.js";
+import { toPortableSchema, writeSchemaFile } from "../../../lib/data-files.js";
+import { unwrapSchemaListResponse } from "../../../lib/data-response.js";
 import { parseCommand, selectedProject } from "../../../lib/workspace.js";
+const PAGE_SIZE = 500;
 export async function dataSchemaPull(argv) {
     const { flags } = parseCommand(argv);
     const projectKey = await selectedProject(flags);
-    const result = await blocksRequest("/data/v4/schemas", {
-        impersonatedProjectAuth: true,
-        ...requestContext(flags),
-        projectTenantId: projectKey,
-        query: { PageNo: 1, PageSize: 500, ProjectKey: projectKey }
-    });
+    const items = [];
+    let pageNo = 1;
+    let totalCount = Infinity;
+    while (items.length < totalCount) {
+        const response = await blocksRequest("/data/v4/schemas", {
+            impersonatedProjectAuth: true,
+            ...requestContext(flags),
+            projectTenantId: projectKey,
+            query: { PageNo: pageNo, PageSize: PAGE_SIZE, ProjectKey: projectKey }
+        });
+        const page = unwrapSchemaListResponse(response);
+        totalCount = page.totalCount;
+        if (page.items.length === 0)
+            break;
+        items.push(...page.items);
+        pageNo += 1;
+    }
     const files = [];
-    for (const schema of result.data?.items ?? []) {
-        files.push(await writeSchemaFile(schema));
+    for (const schema of items) {
+        files.push(await writeSchemaFile(toPortableSchema(schema)));
     }
     writeOutput({ files, count: files.length }, flags);
 }

package/dist/commands/data/schema/push.js

@@ -2,6 +2,7 @@ import { booleanFlag } from "../../../lib/args.js";
 import { blocksRequest } from "../../../lib/api.js";
 import { confirmMutation } from "../../../lib/confirm.js";
 import { readSchemaFiles, validateSchemas } from "../../../lib/data-files.js";
+import { isRecord, unwrapSchemaListResponse } from "../../../lib/data-response.js";
 import { writeOutput } from "../../../lib/output.js";
 import { requestContext } from "../../../lib/request-context.js";
 import { parseCommand, selectedProject } from "../../../lib/workspace.js";
@@ -18,22 +19,43 @@ export async function dataSchemaPush(argv) {
     }
     await confirmMutation(flags, `Push ${schemas.length} data schema file(s) to project '${projectKey}'.`);
     const results = [];
-    for (const { schema } of schemas) {
-        const existing = await blocksRequest("/data/v4/schemas", {
+    const warnings = [];
+    for (const { file, schema } of schemas) {
+        const schemaName = String(schema.schemaName);
+        const localId = schema.itemId ?? schema.id;
+        // Look up the destination project's own copy of this schema by name -- a
+        // local id/itemId may belong to a different project and must never be
+        // trusted directly (see CLAUDE_HANDOFF.md #1).
+        const existingResponse = await blocksRequest("/data/v4/schemas", {
             impersonatedProjectAuth: true,
             ...requestContext(flags),
             projectTenantId: projectKey,
-            query: { PageNo: 1, PageSize: 5, ProjectKey: projectKey, SchemaName: String(schema.schemaName) }
+            query: { PageNo: 1, PageSize: 5, ProjectKey: projectKey, SchemaName: schemaName }
         });
-        const itemId = schema.itemId ?? existing.data?.items?.[0]?.itemId;
-        const body = { ...schema, itemId, projectKey };
-        results.push(await blocksRequest("/data/v4/schemas/define", {
+        const { items } = unwrapSchemaListResponse(existingResponse);
+        const destination = items.find((item) => item.schemaName === schemaName);
+        const destinationId = typeof destination?.id === "string" ? destination.id : undefined;
+        if (!destinationId && localId) {
+            warnings.push(`${file}: ignoring local id for '${schemaName}' -- no matching schema found in project '${projectKey}'; creating instead.`);
+        }
+        const portable = { ...schema };
+        delete portable.itemId;
+        delete portable.id;
+        const body = destinationId ? { ...portable, itemId: destinationId, projectKey } : { ...portable, projectKey };
+        const response = await blocksRequest("/data/v4/schemas/define", {
             body,
             impersonatedProjectAuth: true,
             ...requestContext(flags),
             projectTenantId: projectKey,
-            method: itemId ? "PUT" : "POST"
-        }));
+            method: destinationId ? "PUT" : "POST"
+        });
+        if (response === undefined || response === null) {
+            throw new Error(`Push failed for schema '${schemaName}': the server returned an empty response.`);
+        }
+        if (isRecord(response) && response.isSuccess === false) {
+            throw new Error(`Push failed for schema '${schemaName}': ${JSON.stringify(response)}`);
+        }
+        results.push(response);
     }
-    writeOutput({ results }, flags);
+    writeOutput({ results, ...(warnings.length ? { warnings } : {}) }, flags);
 }