@carthooks/arcubase-cli 0.1.24 → 0.1.25

package/bundle/arcubase-admin.mjs

@@ -18689,7 +18689,15 @@ function renderCommandHelpExamples(scope, command) {
   ].join("\n").trimEnd();
 }
 
-// src/runtime/dev_sdk_gen.ts
+// node_modules/@arcubase/code-gen/dist/index.js
+var ArcubaseCodeGenError = class extends Error {
+  code;
+  constructor(code, message) {
+    super(message);
+    this.code = code;
+    this.name = "ArcubaseCodeGenError";
+  }
+};
 function isRecord3(value) {
   return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }
@@ -18698,7 +18706,8 @@ function unwrapData(payload) {
 }
 function toPascalCase(value) {
   const words = value.replace(/([a-z0-9])([A-Z])/g, "$1 $2").split(/[^A-Za-z0-9]+/).filter(Boolean);
-  if (words.length === 0) return "Entity";
+  if (words.length === 0)
+    return "Entity";
   return words.map((word) => `${word[0].toUpperCase()}${word.slice(1)}`).join("");
 }
 function toCamelCase(value) {
@@ -18738,11 +18747,11 @@ function normalizeFieldType(type) {
 function normalizeEntities(payload) {
   const root = unwrapData(payload);
   if (!isRecord3(root)) {
-    throw new CLIError("SDK_GEN_INVALID_SCHEMA", "sdk-gen expected an app detail object", 2);
+    throw new ArcubaseCodeGenError("SDK_GEN_INVALID_SCHEMA", "sdk-gen expected an app detail object");
   }
   const appId = typeof root.id === "number" ? root.id : typeof root.app_id === "number" ? root.app_id : void 0;
   if (!appId) {
-    throw new CLIError("SDK_GEN_APP_ID_REQUIRED", "sdk-gen expected app id in app detail response", 2);
+    throw new ArcubaseCodeGenError("SDK_GEN_APP_ID_REQUIRED", "sdk-gen expected app id in app detail response");
   }
   const sourceEntities = Array.isArray(root.entities) ? root.entities : Array.isArray(root.tables) ? root.tables : Array.isArray(root.entitys) ? root.entitys : [];
   const entities = sourceEntities.filter((item) => isRecord3(item)).filter((item) => typeof item.id === "number" && typeof item.name === "string").map((item) => {
@@ -18765,7 +18774,7 @@ function normalizeEntities(payload) {
     return entity;
   });
   if (entities.length === 0) {
-    throw new CLIError("SDK_GEN_NO_ENTITIES", "sdk-gen could not find entities in app detail response", 2);
+    throw new ArcubaseCodeGenError("SDK_GEN_NO_ENTITIES", "sdk-gen could not find entities in app detail response");
   }
   validateEntities(entities);
   return entities;
@@ -18774,19 +18783,19 @@ function validateEntities(entities) {
   const entityKeys = /* @__PURE__ */ new Set();
   for (const entity of entities) {
     if (entityKeys.has(entity.sdkName)) {
-      throw new CLIError("SDK_GEN_DUPLICATE_ENTITY_KEY", `duplicate generated entity key: ${entity.sdkName}`, 2);
+      throw new ArcubaseCodeGenError("SDK_GEN_DUPLICATE_ENTITY_KEY", `duplicate generated entity key: ${entity.sdkName}`);
     }
     entityKeys.add(entity.sdkName);
     const fieldKeys = /* @__PURE__ */ new Set();
     for (const field of entity.fields) {
       if (!field.key) {
-        throw new CLIError("SDK_GEN_FIELD_KEY_REQUIRED", `field.key is required for ${entity.name}.${field.label} (${field.id})`, 2);
+        throw new ArcubaseCodeGenError("SDK_GEN_FIELD_KEY_REQUIRED", `field.key is required for ${entity.name}.${field.label} (${field.id})`);
       }
       if (!/^[A-Za-z][A-Za-z0-9_]*$/.test(field.key)) {
-        throw new CLIError("SDK_GEN_INVALID_FIELD_KEY", `field.key must be a TypeScript identifier: ${entity.name}.${field.key}`, 2);
+        throw new ArcubaseCodeGenError("SDK_GEN_INVALID_FIELD_KEY", `field.key must be a TypeScript identifier: ${entity.name}.${field.key}`);
       }
       if (fieldKeys.has(field.key)) {
-        throw new CLIError("SDK_GEN_DUPLICATE_FIELD_KEY", `duplicate field.key in ${entity.name}: ${field.key}`, 2);
+        throw new ArcubaseCodeGenError("SDK_GEN_DUPLICATE_FIELD_KEY", `duplicate field.key in ${entity.name}: ${field.key}`);
       }
       fieldKeys.add(field.key);
     }
@@ -18991,6 +19000,18 @@ function generateArcubaseProjectSDK(payload) {
   };
 }
 
+// src/runtime/dev_sdk_gen.ts
+function generateArcubaseProjectSDK2(payload) {
+  try {
+    return generateArcubaseProjectSDK(payload);
+  } catch (error51) {
+    if (error51 instanceof ArcubaseCodeGenError) {
+      throw new CLIError(error51.code, error51.message, 2);
+    }
+    throw error51;
+  }
+}
+
 // src/runtime/execute.ts
 function renderRootHelp(scope) {
   const binary = scope === "admin" ? "arcubase-admin" : "arcubase";
@@ -19222,7 +19243,7 @@ function renderDevSDKGenHelp() {
     "  - arcubase-admin dev sdk-gen --app-id <app_id> --out src/arcubase",
     "",
     "requirements:",
-    "  - missing field.key values are initialized through admin auth as field<id>",
+    "  - every generated field must have a configured field.key; sdk-gen fails fast when keys are missing",
     "  - existing field.key values must be stable unique TypeScript identifiers",
     "  - entity property names use entity.key when available, otherwise a stable entity<id> fallback",
     "  - generated code accepts createArcubaseSdk({ baseURL, accessToken, refreshToken })"
@@ -20735,45 +20756,37 @@ function walkSDKGenFields(fields, visit) {
     walkSDKGenFields(field.children, visit);
   }
 }
-function collectExistingSDKGenFieldKeys(entity) {
-  const keys = /* @__PURE__ */ new Set();
-  walkSDKGenFields(entity.fields, (field) => {
-    if (typeof field.key === "string" && field.key.trim() !== "") {
-      keys.add(field.key.trim());
-    }
-  });
-  return keys;
-}
-function nextSDKGenFallbackFieldKey(fieldId, usedKeys) {
-  const base = `field${fieldId}`;
-  if (!usedKeys.has(base)) {
-    usedKeys.add(base);
-    return base;
-  }
-  let index = 2;
-  while (usedKeys.has(`${base}_${index}`)) {
-    index++;
-  }
-  const key = `${base}_${index}`;
-  usedKeys.add(key);
-  return key;
-}
-function initializeMissingSDKGenFieldKeys(entity) {
-  const usedKeys = collectExistingSDKGenFieldKeys(entity);
-  const updates = [];
+function assertSDKGenFieldKeysPresent(entity) {
+  const missing = [];
   walkSDKGenFields(entity.fields, (field) => {
     if (typeof field.id !== "number") {
       return;
     }
     if (typeof field.key === "string" && field.key.trim() !== "") {
-      field.key = field.key.trim();
       return;
     }
-    const key = nextSDKGenFallbackFieldKey(field.id, usedKeys);
-    field.key = key;
-    updates.push({ id: field.id, key });
+    missing.push({
+      id: field.id,
+      label: typeof field.label === "string" && field.label.trim() ? field.label.trim() : `field ${field.id}`
+    });
+  });
+  if (missing.length === 0) {
+    return;
+  }
+  const entityName = typeof entity.name === "string" && entity.name.trim() ? entity.name.trim() : `entity ${String(entity.id ?? "")}`.trim();
+  const preview = missing.slice(0, 8).map((field) => `${entityName}.${field.label} (${field.id})`);
+  const suffix = missing.length > preview.length ? `, and ${missing.length - preview.length} more` : "";
+  throw new CLIError("SDK_GEN_FIELD_KEY_REQUIRED", `missing field.key values: ${preview.join(", ")}${suffix}`, 2, {
+    operation: "dev sdk-gen",
+    issues: missing.map((field) => ({
+      path: `entity.${String(entity.id ?? "unknown")}.field.${field.id}.key`,
+      message: `field.key is required for ${entityName}.${field.label}`
+    })),
+    suggestions: [
+      "set stable field.key values in Arcubase admin before running sdk-gen",
+      "rerun arcubase-admin dev sdk-gen after the schema keys are complete"
+    ]
   });
-  return updates;
 }
 async function executeDevSDKGen(runtimeEnv, flags, fetchImpl) {
   validateDevSDKGenFlags(flags);
@@ -20802,7 +20815,6 @@ async function executeDevSDKGen(runtimeEnv, flags, fetchImpl) {
     throw new CLIError("SDK_GEN_NO_ENTITIES", "sdk-gen could not find entities in app detail response", 2);
   }
   const entities = [];
-  const initializedFieldKeys = [];
   for (const entityRef of entityRefs) {
     const entityEndpoint = `/api/apps/${encodeURIComponent(appId)}/entity/${encodeURIComponent(entityRef.id)}`;
     const entityDetail = await requestJSON(runtimeEnv, "GET", entityEndpoint, void 0, fetchImpl);
@@ -20810,18 +20822,10 @@ async function executeDevSDKGen(runtimeEnv, flags, fetchImpl) {
     if (!isRecord4(entityPayload)) {
       throw new CLIError("SDK_GEN_INVALID_SCHEMA", "sdk-gen expected entity detail response data", 2);
     }
-    const customKeyUpdates = initializeMissingSDKGenFieldKeys(entityPayload);
-    if (customKeyUpdates.length > 0) {
-      const customKeysEndpoint = `/api/apps/${encodeURIComponent(appId)}/entity/${encodeURIComponent(entityRef.id)}/custom-keys`;
-      await requestJSON(runtimeEnv, "PUT", customKeysEndpoint, customKeyUpdates, fetchImpl);
-      initializedFieldKeys.push({
-        entityId: typeof entityPayload.id === "number" ? entityPayload.id : Number(entityRef.id),
-        fields: customKeyUpdates.map((item) => item.key)
-      });
-    }
+    assertSDKGenFieldKeysPresent(entityPayload);
     entities.push(entityPayload);
   }
-  const generated = generateArcubaseProjectSDK({
+  const generated = generateArcubaseProjectSDK2({
     id: resolveSDKGenAppId(appId, appPayload),
     name: typeof appPayload.name === "string" ? appPayload.name : void 0,
     entities
@@ -20841,8 +20845,7 @@ async function executeDevSDKGen(runtimeEnv, flags, fetchImpl) {
     status: appDetail.status,
     data: {
       out: absoluteOutDir,
-      files: generated.files.map((file2) => file2.path),
-      initializedFieldKeys
+      files: generated.files.map((file2) => file2.path)
     }
   };
 }

package/bundle/arcubase.mjs

@@ -18689,7 +18689,15 @@ function renderCommandHelpExamples(scope, command) {
   ].join("\n").trimEnd();
 }
 
-// src/runtime/dev_sdk_gen.ts
+// node_modules/@arcubase/code-gen/dist/index.js
+var ArcubaseCodeGenError = class extends Error {
+  code;
+  constructor(code, message) {
+    super(message);
+    this.code = code;
+    this.name = "ArcubaseCodeGenError";
+  }
+};
 function isRecord3(value) {
   return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }
@@ -18698,7 +18706,8 @@ function unwrapData(payload) {
 }
 function toPascalCase(value) {
   const words = value.replace(/([a-z0-9])([A-Z])/g, "$1 $2").split(/[^A-Za-z0-9]+/).filter(Boolean);
-  if (words.length === 0) return "Entity";
+  if (words.length === 0)
+    return "Entity";
   return words.map((word) => `${word[0].toUpperCase()}${word.slice(1)}`).join("");
 }
 function toCamelCase(value) {
@@ -18738,11 +18747,11 @@ function normalizeFieldType(type) {
 function normalizeEntities(payload) {
   const root = unwrapData(payload);
   if (!isRecord3(root)) {
-    throw new CLIError("SDK_GEN_INVALID_SCHEMA", "sdk-gen expected an app detail object", 2);
+    throw new ArcubaseCodeGenError("SDK_GEN_INVALID_SCHEMA", "sdk-gen expected an app detail object");
   }
   const appId = typeof root.id === "number" ? root.id : typeof root.app_id === "number" ? root.app_id : void 0;
   if (!appId) {
-    throw new CLIError("SDK_GEN_APP_ID_REQUIRED", "sdk-gen expected app id in app detail response", 2);
+    throw new ArcubaseCodeGenError("SDK_GEN_APP_ID_REQUIRED", "sdk-gen expected app id in app detail response");
   }
   const sourceEntities = Array.isArray(root.entities) ? root.entities : Array.isArray(root.tables) ? root.tables : Array.isArray(root.entitys) ? root.entitys : [];
   const entities = sourceEntities.filter((item) => isRecord3(item)).filter((item) => typeof item.id === "number" && typeof item.name === "string").map((item) => {
@@ -18765,7 +18774,7 @@ function normalizeEntities(payload) {
     return entity;
   });
   if (entities.length === 0) {
-    throw new CLIError("SDK_GEN_NO_ENTITIES", "sdk-gen could not find entities in app detail response", 2);
+    throw new ArcubaseCodeGenError("SDK_GEN_NO_ENTITIES", "sdk-gen could not find entities in app detail response");
   }
   validateEntities(entities);
   return entities;
@@ -18774,19 +18783,19 @@ function validateEntities(entities) {
   const entityKeys = /* @__PURE__ */ new Set();
   for (const entity of entities) {
     if (entityKeys.has(entity.sdkName)) {
-      throw new CLIError("SDK_GEN_DUPLICATE_ENTITY_KEY", `duplicate generated entity key: ${entity.sdkName}`, 2);
+      throw new ArcubaseCodeGenError("SDK_GEN_DUPLICATE_ENTITY_KEY", `duplicate generated entity key: ${entity.sdkName}`);
     }
     entityKeys.add(entity.sdkName);
     const fieldKeys = /* @__PURE__ */ new Set();
     for (const field of entity.fields) {
       if (!field.key) {
-        throw new CLIError("SDK_GEN_FIELD_KEY_REQUIRED", `field.key is required for ${entity.name}.${field.label} (${field.id})`, 2);
+        throw new ArcubaseCodeGenError("SDK_GEN_FIELD_KEY_REQUIRED", `field.key is required for ${entity.name}.${field.label} (${field.id})`);
       }
       if (!/^[A-Za-z][A-Za-z0-9_]*$/.test(field.key)) {
-        throw new CLIError("SDK_GEN_INVALID_FIELD_KEY", `field.key must be a TypeScript identifier: ${entity.name}.${field.key}`, 2);
+        throw new ArcubaseCodeGenError("SDK_GEN_INVALID_FIELD_KEY", `field.key must be a TypeScript identifier: ${entity.name}.${field.key}`);
       }
       if (fieldKeys.has(field.key)) {
-        throw new CLIError("SDK_GEN_DUPLICATE_FIELD_KEY", `duplicate field.key in ${entity.name}: ${field.key}`, 2);
+        throw new ArcubaseCodeGenError("SDK_GEN_DUPLICATE_FIELD_KEY", `duplicate field.key in ${entity.name}: ${field.key}`);
       }
       fieldKeys.add(field.key);
     }
@@ -18991,6 +19000,18 @@ function generateArcubaseProjectSDK(payload) {
   };
 }
 
+// src/runtime/dev_sdk_gen.ts
+function generateArcubaseProjectSDK2(payload) {
+  try {
+    return generateArcubaseProjectSDK(payload);
+  } catch (error51) {
+    if (error51 instanceof ArcubaseCodeGenError) {
+      throw new CLIError(error51.code, error51.message, 2);
+    }
+    throw error51;
+  }
+}
+
 // src/runtime/execute.ts
 function renderRootHelp(scope) {
   const binary = scope === "admin" ? "arcubase-admin" : "arcubase";
@@ -19222,7 +19243,7 @@ function renderDevSDKGenHelp() {
     "  - arcubase-admin dev sdk-gen --app-id <app_id> --out src/arcubase",
     "",
     "requirements:",
-    "  - missing field.key values are initialized through admin auth as field<id>",
+    "  - every generated field must have a configured field.key; sdk-gen fails fast when keys are missing",
     "  - existing field.key values must be stable unique TypeScript identifiers",
     "  - entity property names use entity.key when available, otherwise a stable entity<id> fallback",
     "  - generated code accepts createArcubaseSdk({ baseURL, accessToken, refreshToken })"
@@ -20735,45 +20756,37 @@ function walkSDKGenFields(fields, visit) {
     walkSDKGenFields(field.children, visit);
   }
 }
-function collectExistingSDKGenFieldKeys(entity) {
-  const keys = /* @__PURE__ */ new Set();
-  walkSDKGenFields(entity.fields, (field) => {
-    if (typeof field.key === "string" && field.key.trim() !== "") {
-      keys.add(field.key.trim());
-    }
-  });
-  return keys;
-}
-function nextSDKGenFallbackFieldKey(fieldId, usedKeys) {
-  const base = `field${fieldId}`;
-  if (!usedKeys.has(base)) {
-    usedKeys.add(base);
-    return base;
-  }
-  let index = 2;
-  while (usedKeys.has(`${base}_${index}`)) {
-    index++;
-  }
-  const key = `${base}_${index}`;
-  usedKeys.add(key);
-  return key;
-}
-function initializeMissingSDKGenFieldKeys(entity) {
-  const usedKeys = collectExistingSDKGenFieldKeys(entity);
-  const updates = [];
+function assertSDKGenFieldKeysPresent(entity) {
+  const missing = [];
   walkSDKGenFields(entity.fields, (field) => {
     if (typeof field.id !== "number") {
       return;
     }
     if (typeof field.key === "string" && field.key.trim() !== "") {
-      field.key = field.key.trim();
       return;
     }
-    const key = nextSDKGenFallbackFieldKey(field.id, usedKeys);
-    field.key = key;
-    updates.push({ id: field.id, key });
+    missing.push({
+      id: field.id,
+      label: typeof field.label === "string" && field.label.trim() ? field.label.trim() : `field ${field.id}`
+    });
+  });
+  if (missing.length === 0) {
+    return;
+  }
+  const entityName = typeof entity.name === "string" && entity.name.trim() ? entity.name.trim() : `entity ${String(entity.id ?? "")}`.trim();
+  const preview = missing.slice(0, 8).map((field) => `${entityName}.${field.label} (${field.id})`);
+  const suffix = missing.length > preview.length ? `, and ${missing.length - preview.length} more` : "";
+  throw new CLIError("SDK_GEN_FIELD_KEY_REQUIRED", `missing field.key values: ${preview.join(", ")}${suffix}`, 2, {
+    operation: "dev sdk-gen",
+    issues: missing.map((field) => ({
+      path: `entity.${String(entity.id ?? "unknown")}.field.${field.id}.key`,
+      message: `field.key is required for ${entityName}.${field.label}`
+    })),
+    suggestions: [
+      "set stable field.key values in Arcubase admin before running sdk-gen",
+      "rerun arcubase-admin dev sdk-gen after the schema keys are complete"
+    ]
   });
-  return updates;
 }
 async function executeDevSDKGen(runtimeEnv, flags, fetchImpl) {
   validateDevSDKGenFlags(flags);
@@ -20802,7 +20815,6 @@ async function executeDevSDKGen(runtimeEnv, flags, fetchImpl) {
     throw new CLIError("SDK_GEN_NO_ENTITIES", "sdk-gen could not find entities in app detail response", 2);
   }
   const entities = [];
-  const initializedFieldKeys = [];
   for (const entityRef of entityRefs) {
     const entityEndpoint = `/api/apps/${encodeURIComponent(appId)}/entity/${encodeURIComponent(entityRef.id)}`;
     const entityDetail = await requestJSON(runtimeEnv, "GET", entityEndpoint, void 0, fetchImpl);
@@ -20810,18 +20822,10 @@ async function executeDevSDKGen(runtimeEnv, flags, fetchImpl) {
     if (!isRecord4(entityPayload)) {
       throw new CLIError("SDK_GEN_INVALID_SCHEMA", "sdk-gen expected entity detail response data", 2);
     }
-    const customKeyUpdates = initializeMissingSDKGenFieldKeys(entityPayload);
-    if (customKeyUpdates.length > 0) {
-      const customKeysEndpoint = `/api/apps/${encodeURIComponent(appId)}/entity/${encodeURIComponent(entityRef.id)}/custom-keys`;
-      await requestJSON(runtimeEnv, "PUT", customKeysEndpoint, customKeyUpdates, fetchImpl);
-      initializedFieldKeys.push({
-        entityId: typeof entityPayload.id === "number" ? entityPayload.id : Number(entityRef.id),
-        fields: customKeyUpdates.map((item) => item.key)
-      });
-    }
+    assertSDKGenFieldKeysPresent(entityPayload);
     entities.push(entityPayload);
   }
-  const generated = generateArcubaseProjectSDK({
+  const generated = generateArcubaseProjectSDK2({
     id: resolveSDKGenAppId(appId, appPayload),
     name: typeof appPayload.name === "string" ? appPayload.name : void 0,
     entities
@@ -20841,8 +20845,7 @@ async function executeDevSDKGen(runtimeEnv, flags, fetchImpl) {
     status: appDetail.status,
     data: {
       out: absoluteOutDir,
-      files: generated.files.map((file2) => file2.path),
-      initializedFieldKeys
+      files: generated.files.map((file2) => file2.path)
     }
   };
 }

package/dist/runtime/dev_sdk_gen.d.ts

@@ -1,9 +1,4 @@
-export type GeneratedSDKFile = {
-    path: string;
-    contents: string;
-};
-export type GeneratedSDK = {
-    files: GeneratedSDKFile[];
-};
+import { type GeneratedSDK } from '@arcubase/code-gen';
+export type { GeneratedSDK, GeneratedSDKFile } from '@arcubase/code-gen';
 export declare function generateArcubaseProjectSDK(payload: unknown): GeneratedSDK;
 //# sourceMappingURL=dev_sdk_gen.d.ts.map

package/dist/runtime/dev_sdk_gen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dev_sdk_gen.d.ts","sourceRoot":"","sources":["../../src/runtime/dev_sdk_gen.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,gBAAgB,EAAE,CAAA;CAC1B,CAAA;AAmVD,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,CAWzE"}
+{"version":3,"file":"dev_sdk_gen.d.ts","sourceRoot":"","sources":["../../src/runtime/dev_sdk_gen.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,oBAAoB,CAAA;AAI3B,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAExE,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,CASzE"}