@stardeck-customer-apps/data-store-sdk 0.5.0 → 0.6.0

package/dist/cli/bin.mjs

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import {
+  main
+} from "../chunk-EWWQPGFI.mjs";
+import "../chunk-FEKROS4B.mjs";
+
+// src/cli/bin.ts
+main().catch((error) => {
+  console.error(error instanceof Error ? error.message : String(error));
+  process.exit(1);
+});

package/dist/cli/generate-types.d.mts

@@ -1,4 +1,3 @@
-#!/usr/bin/env node
 declare function toPascalCase(name: string): string;
 
 interface ColumnInfo {
@@ -13,6 +12,8 @@ declare function pgTypeToTs(pgType: string): string;
 
 type ParsedCliArgs = {
     connectionString: string | undefined;
+    /** `--store`: which manifest entry to use when the app has several connected. */
+    store: string | undefined;
     outputPath: string;
     schemaOutputPath: string | undefined;
     emitSchema: boolean;
@@ -45,6 +46,30 @@ type RunGenerateTypesOptions = {
  * so tests can stub the pool without a live database.
  */
 declare function runGenerateTypes(options: RunGenerateTypesOptions): Promise<void>;
+/**
+ * The connection string for the store the app is pointed at, from the manifest
+ * the app runtime itself resolves stores from. `--store` picks one entry the way
+ * `resolveDataStore` does (id, binding key, slug, name); otherwise the app's
+ * single database store is the answer, and anything else is an error the
+ * operator can act on. Storage stores carry no url and never count.
+ */
+declare function connectionStringFromManifest(store: string | undefined): {
+    url: string;
+} | {
+    error: string;
+};
+/**
+ * Load `./.env.local` the way the app's `next dev` reads it. `env:pull` writes
+ * the file for `@next/env` — dotenv parse followed by dotenv-expand — and
+ * escapes every `$` as `\$` so expand leaves the value alone; Node's parser
+ * keeps that backslash, which turns a manifest holding a `$` (a store name, a
+ * password) into invalid JSON. Undo the one escape so the manifest is the JSON
+ * the app sees. Shell values win over the file, like `node --env-file`.
+ *
+ * ponytail: no `$VAR` expansion of hand-edited lines; `env:pull` never writes
+ * one. Add dotenv-expand if a file ever needs it.
+ */
+declare function loadEnvLocal(cwd: string): void;
 declare function main(argv?: string[]): Promise<void>;
 
-export { type ColumnInfo, PG_TYPE_MAP, type ParsedCliArgs, type RunGenerateTypesOptions, generateTypeScript, introspectSchema, main, parseCliArgs, pgTypeToTs, runGenerateTypes, toPascalCase };
+export { type ColumnInfo, PG_TYPE_MAP, type ParsedCliArgs, type RunGenerateTypesOptions, connectionStringFromManifest, generateTypeScript, introspectSchema, loadEnvLocal, main, parseCliArgs, pgTypeToTs, runGenerateTypes, toPascalCase };

package/dist/cli/generate-types.d.ts

@@ -1,4 +1,3 @@
-#!/usr/bin/env node
 declare function toPascalCase(name: string): string;
 
 interface ColumnInfo {
@@ -13,6 +12,8 @@ declare function pgTypeToTs(pgType: string): string;
 
 type ParsedCliArgs = {
     connectionString: string | undefined;
+    /** `--store`: which manifest entry to use when the app has several connected. */
+    store: string | undefined;
     outputPath: string;
     schemaOutputPath: string | undefined;
     emitSchema: boolean;
@@ -45,6 +46,30 @@ type RunGenerateTypesOptions = {
  * so tests can stub the pool without a live database.
  */
 declare function runGenerateTypes(options: RunGenerateTypesOptions): Promise<void>;
+/**
+ * The connection string for the store the app is pointed at, from the manifest
+ * the app runtime itself resolves stores from. `--store` picks one entry the way
+ * `resolveDataStore` does (id, binding key, slug, name); otherwise the app's
+ * single database store is the answer, and anything else is an error the
+ * operator can act on. Storage stores carry no url and never count.
+ */
+declare function connectionStringFromManifest(store: string | undefined): {
+    url: string;
+} | {
+    error: string;
+};
+/**
+ * Load `./.env.local` the way the app's `next dev` reads it. `env:pull` writes
+ * the file for `@next/env` — dotenv parse followed by dotenv-expand — and
+ * escapes every `$` as `\$` so expand leaves the value alone; Node's parser
+ * keeps that backslash, which turns a manifest holding a `$` (a store name, a
+ * password) into invalid JSON. Undo the one escape so the manifest is the JSON
+ * the app sees. Shell values win over the file, like `node --env-file`.
+ *
+ * ponytail: no `$VAR` expansion of hand-edited lines; `env:pull` never writes
+ * one. Add dotenv-expand if a file ever needs it.
+ */
+declare function loadEnvLocal(cwd: string): void;
 declare function main(argv?: string[]): Promise<void>;
 
-export { type ColumnInfo, PG_TYPE_MAP, type ParsedCliArgs, type RunGenerateTypesOptions, generateTypeScript, introspectSchema, main, parseCliArgs, pgTypeToTs, runGenerateTypes, toPascalCase };
+export { type ColumnInfo, PG_TYPE_MAP, type ParsedCliArgs, type RunGenerateTypesOptions, connectionStringFromManifest, generateTypeScript, introspectSchema, loadEnvLocal, main, parseCliArgs, pgTypeToTs, runGenerateTypes, toPascalCase };

package/dist/cli/generate-types.js

@@ -1,4 +1,3 @@
-#!/usr/bin/env node
 "use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;
@@ -32,8 +31,10 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var generate_types_exports = {};
 __export(generate_types_exports, {
   PG_TYPE_MAP: () => PG_TYPE_MAP,
+  connectionStringFromManifest: () => connectionStringFromManifest,
   generateTypeScript: () => generateTypeScript,
   introspectSchema: () => introspectSchema,
+  loadEnvLocal: () => loadEnvLocal,
   main: () => main,
   parseCliArgs: () => parseCliArgs,
   pgTypeToTs: () => pgTypeToTs,
@@ -43,9 +44,63 @@ __export(generate_types_exports, {
 module.exports = __toCommonJS(generate_types_exports);
 var import_fs2 = require("fs");
 var import_path2 = require("path");
-var import_url = require("url");
+var import_util = require("util");
 var import_serverless = require("@neondatabase/serverless");
 
+// src/server/manifest.ts
+var STARDECK_DATA_STORES_ENV = "STARDECK_DATA_STORES";
+function readEnv(key) {
+  if (typeof process !== "undefined" && process.env?.[key]) {
+    return process.env[key];
+  }
+  return void 0;
+}
+function dataStoreSlug(name) {
+  const slug = name.toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "");
+  return slug || "store";
+}
+function readDataStoreManifest() {
+  const raw = readEnv(STARDECK_DATA_STORES_ENV);
+  if (!raw) return [];
+  try {
+    const parsed = JSON.parse(raw);
+    if (!Array.isArray(parsed)) return [];
+    return parsed.filter((e) => {
+      if (typeof e !== "object" || e === null) return false;
+      const entry = e;
+      if (typeof entry.id !== "string" || typeof entry.name !== "string" || typeof entry.slug !== "string") {
+        return false;
+      }
+      return entry.storeType === "storage" || typeof entry.url === "string";
+    });
+  } catch {
+    return [];
+  }
+}
+function resolveDataStore(ref) {
+  return resolveManifestEntry(readDataStoreManifest(), ref);
+}
+function resolveManifestEntry(entries, ref) {
+  if (ref.storeId) {
+    const byId = entries.find((e) => e.id === ref.storeId);
+    if (byId) return byId;
+  }
+  if (ref.storeName) {
+    const target = ref.storeName;
+    const byBindingKey = entries.find((e) => e.bindingKey === target);
+    if (byBindingKey) return byBindingKey;
+    const exact = entries.find((e) => e.slug === target || e.id === target || e.name === target);
+    if (exact) return exact;
+    const norm = dataStoreSlug(target);
+    const byBindingKeyNorm = entries.find((e) => e.bindingKey === norm);
+    if (byBindingKeyNorm) return byBindingKeyNorm;
+    return entries.find(
+      (e) => e.slug === norm || typeof e.name === "string" && dataStoreSlug(e.name) === norm
+    );
+  }
+  return void 0;
+}
+
 // src/cli/module-type-slices.ts
 var import_fs = require("fs");
 var import_path = require("path");
@@ -408,7 +463,6 @@ function generateSchemaSql(snapshot) {
 }
 
 // src/cli/generate-types.ts
-var import_meta = {};
 var PG_TYPE_MAP = {
   text: "string",
   varchar: "string",
@@ -445,19 +499,23 @@ function parseCliArgs(argv, options = {}) {
   const cwd = options.cwd ?? process.cwd();
   const env = options.env ?? process.env;
   let connectionString = env.DATA_STORE_URL;
+  let store;
   let outputPath = "./src/generated/data-store-types.ts";
   let schemaOutputPath;
-  let emitSchema = true;
+  let emitSchema = !(0, import_fs2.existsSync)((0, import_path2.resolve)(cwd, "datastore/ledger-order.json"));
   let modulesDir = (0, import_path2.resolve)(cwd, "./src/modules");
   let noModules = false;
   let help = false;
   for (let i = 0; i < argv.length; i++) {
     if (argv[i] === "--connection-string" && argv[i + 1]) {
       connectionString = argv[++i];
+    } else if (argv[i] === "--store" && argv[i + 1]) {
+      store = argv[++i];
     } else if (argv[i] === "--output" && argv[i + 1]) {
       outputPath = argv[++i];
     } else if (argv[i] === "--schema-output" && argv[i + 1]) {
       schemaOutputPath = argv[++i];
+      emitSchema = true;
     } else if (argv[i] === "--no-schema") {
       emitSchema = false;
     } else if (argv[i] === "--modules-dir" && argv[i + 1]) {
@@ -470,6 +528,7 @@ function parseCliArgs(argv, options = {}) {
   }
   return {
     connectionString,
+    store,
     outputPath,
     schemaOutputPath,
     emitSchema,
@@ -602,29 +661,77 @@ async function runGenerateTypes(options) {
     }
   }
 }
+function connectionStringFromManifest(store) {
+  const databases = readDataStoreManifest().filter((entry) => entry.storeType !== "storage");
+  if (store) {
+    const match = resolveDataStore({ storeName: store });
+    if (!match?.url) {
+      return {
+        error: `No connected database store matches --store ${store}. Connected: ${listStores(databases)}.`
+      };
+    }
+    return { url: match.url };
+  }
+  if (databases.length === 1 && databases[0]?.url) return { url: databases[0].url };
+  if (databases.length === 0) {
+    return {
+      error: "No connected database store found. Run `npm run env:pull` in apps/web to write .env.local, or pass --connection-string."
+    };
+  }
+  return {
+    error: `${databases.length} database stores are connected; pass --store <bindingKey>. Connected: ${listStores(databases)}.`
+  };
+}
+function listStores(entries) {
+  return entries.length === 0 ? "none" : entries.map((entry) => entry.bindingKey ?? entry.slug).join(", ");
+}
+function loadEnvLocal(cwd) {
+  const path = (0, import_path2.resolve)(cwd, ".env.local");
+  let content;
+  try {
+    content = (0, import_fs2.readFileSync)(path, "utf8");
+  } catch (error) {
+    if (error.code !== "ENOENT") {
+      console.warn(`Warning: could not read ${path}: ${error.message}`);
+    }
+    return;
+  }
+  for (const [key, value] of Object.entries((0, import_util.parseEnv)(content))) {
+    if (value !== void 0 && process.env[key] === void 0) {
+      process.env[key] = value.replace(/\\\$/g, "$");
+    }
+  }
+}
 async function main(argv = process.argv.slice(2)) {
+  loadEnvLocal(process.cwd());
   const parsed = parseCliArgs(argv);
   if (parsed.help) {
     console.log(`Usage: stardeck-data-store generate-types [options]
 
 Options:
-  --connection-string <url>  Postgres connection string (default: DATA_STORE_URL env var)
+  --connection-string <url>  Postgres connection string (default: DATA_STORE_URL, else the
+                             app's connected store from STARDECK_DATA_STORES / .env.local)
+  --store <bindingKey>       Which connected store to read when the app has several
   --output <path>            Output file path (default: ./src/generated/data-store-types.ts)
   --schema-output <path>     DDL snapshot path (default: data-store-schema.sql next to --output)
-  --no-schema                Skip the DDL snapshot used by the test harness
+  --no-schema                Skip the DDL snapshot used by the test harness (implied when
+                             datastore/ledger-order.json exists: a Blueprint composes its own)
   --modules-dir <path>       Directory containing module folders (default: ./src/modules)
   --no-modules               Skip per-module DB slice generation
   --help                     Show this help message`);
     process.exit(0);
   }
-  if (!parsed.connectionString) {
-    console.error(
-      "Error: No connection string provided. Set DATA_STORE_URL or use --connection-string."
-    );
-    process.exit(1);
+  let connectionString = parsed.connectionString;
+  if (!connectionString) {
+    const resolved = connectionStringFromManifest(parsed.store);
+    if ("error" in resolved) {
+      console.error(`Error: ${resolved.error}`);
+      process.exit(1);
+    }
+    connectionString = resolved.url;
   }
   await runGenerateTypes({
-    connectionString: parsed.connectionString,
+    connectionString,
     outputPath: parsed.outputPath,
     schemaOutputPath: parsed.schemaOutputPath,
     emitSchema: parsed.emitSchema,
@@ -632,26 +739,13 @@ Options:
     noModules: parsed.noModules
   });
 }
-function isDirectCliRun() {
-  const entry = process.argv[1];
-  if (!entry) return false;
-  try {
-    return import_meta.url === (0, import_url.pathToFileURL)((0, import_path2.resolve)(entry)).href;
-  } catch {
-    return false;
-  }
-}
-if (isDirectCliRun()) {
-  main().catch((error) => {
-    console.error("Failed to generate types:", error);
-    process.exit(1);
-  });
-}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   PG_TYPE_MAP,
+  connectionStringFromManifest,
   generateTypeScript,
   introspectSchema,
+  loadEnvLocal,
   main,
   parseCliArgs,
   pgTypeToTs,