@stardeck-customer-apps/data-store-sdk 0.1.0-preview.0

package/dist/chunk-7YN3WP4H.mjs

@@ -0,0 +1,43 @@
+// src/errors.ts
+var DataStoreError = class extends Error {
+  code;
+  statusCode;
+  constructor(message, code, statusCode) {
+    super(message);
+    this.name = "DataStoreError";
+    this.code = code;
+    this.statusCode = statusCode;
+  }
+};
+var AuthenticationError = class extends DataStoreError {
+  constructor(message = "Authentication failed") {
+    super(message, "AUTHENTICATION_ERROR", 401);
+    this.name = "AuthenticationError";
+  }
+};
+var ForbiddenError = class extends DataStoreError {
+  constructor(message = "Insufficient access level") {
+    super(message, "FORBIDDEN", 403);
+    this.name = "ForbiddenError";
+  }
+};
+var ValidationError = class extends DataStoreError {
+  constructor(message) {
+    super(message, "VALIDATION_ERROR", 400);
+    this.name = "ValidationError";
+  }
+};
+var NotFoundError = class extends DataStoreError {
+  constructor(message = "Resource not found") {
+    super(message, "NOT_FOUND", 404);
+    this.name = "NotFoundError";
+  }
+};
+
+export {
+  DataStoreError,
+  AuthenticationError,
+  ForbiddenError,
+  ValidationError,
+  NotFoundError
+};

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

@@ -0,0 +1 @@
+#!/usr/bin/env node

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

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli/generate-types.js

@@ -0,0 +1,174 @@
+#!/usr/bin/env node
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// src/cli/generate-types.ts
+var import_fs = require("fs");
+var import_serverless = require("@neondatabase/serverless");
+var PG_TYPE_MAP = {
+  text: "string",
+  varchar: "string",
+  "character varying": "string",
+  char: "string",
+  character: "string",
+  uuid: "string",
+  integer: "number",
+  int: "number",
+  smallint: "number",
+  bigint: "string",
+  // bigint as string to avoid precision loss
+  numeric: "string",
+  decimal: "string",
+  real: "number",
+  "double precision": "number",
+  boolean: "boolean",
+  jsonb: "unknown",
+  json: "unknown",
+  "timestamp with time zone": "Date",
+  "timestamp without time zone": "Date",
+  timestamp: "Date",
+  date: "string",
+  time: "string",
+  "time with time zone": "string",
+  "time without time zone": "string",
+  bytea: "Buffer",
+  "ARRAY": "unknown[]"
+};
+function pgTypeToTs(pgType) {
+  return PG_TYPE_MAP[pgType] ?? "unknown";
+}
+function toPascalCase(name) {
+  return name.split("_").map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join("");
+}
+async function introspectSchema(connectionString) {
+  const pool = new import_serverless.Pool({ connectionString });
+  try {
+    const { rows } = await pool.query(`
+      SELECT
+        c.table_name,
+        c.column_name,
+        c.data_type,
+        c.is_nullable,
+        c.column_default
+      FROM information_schema.columns c
+      JOIN information_schema.tables t
+        ON c.table_name = t.table_name AND c.table_schema = t.table_schema
+      WHERE c.table_schema = 'public'
+        AND t.table_type = 'BASE TABLE'
+        AND t.table_name NOT LIKE '_deleted_%'
+      ORDER BY c.table_name, c.ordinal_position
+    `);
+    const tables = /* @__PURE__ */ new Map();
+    for (const row of rows) {
+      if (!tables.has(row.table_name)) {
+        tables.set(row.table_name, []);
+      }
+      tables.get(row.table_name).push(row);
+    }
+    return tables;
+  } finally {
+    await pool.end();
+  }
+}
+function generateTypeScript(tables) {
+  const lines = [
+    "// Auto-generated by @stardeck-customer-apps/data-store-sdk",
+    "// Do not edit manually \u2014 regenerate with: npx stardeck-data-store generate-types",
+    "",
+    'import type { Generated } from "kysely";',
+    ""
+  ];
+  for (const [tableName, columns] of tables) {
+    const interfaceName = toPascalCase(tableName) + "Table";
+    lines.push(`export interface ${interfaceName} {`);
+    for (const col of columns) {
+      const tsType = pgTypeToTs(col.data_type);
+      const isGenerated = col.column_default !== null;
+      const isNullable = col.is_nullable === "YES";
+      let type = tsType;
+      if (isNullable) {
+        type = `${tsType} | null`;
+      }
+      if (isGenerated) {
+        type = `Generated<${type}>`;
+      }
+      lines.push(`  ${col.column_name}: ${type};`);
+    }
+    lines.push("}");
+    lines.push("");
+  }
+  lines.push("export interface DB {");
+  for (const tableName of tables.keys()) {
+    const interfaceName = toPascalCase(tableName) + "Table";
+    lines.push(`  ${tableName}: ${interfaceName};`);
+  }
+  lines.push("}");
+  lines.push("");
+  return lines.join("\n");
+}
+async function main() {
+  const args = process.argv.slice(2);
+  let connectionString = process.env.DATA_STORE_URL;
+  let outputPath = "./src/generated/data-store-types.ts";
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === "--connection-string" && args[i + 1]) {
+      connectionString = args[++i];
+    } else if (args[i] === "--output" && args[i + 1]) {
+      outputPath = args[++i];
+    } else if (args[i] === "--help") {
+      console.log(`Usage: stardeck-data-store generate-types [options]
+
+Options:
+  --connection-string <url>  Postgres connection string (default: DATA_STORE_URL env var)
+  --output <path>            Output file path (default: ./src/generated/data-store-types.ts)
+  --help                     Show this help message`);
+      process.exit(0);
+    }
+  }
+  if (!connectionString) {
+    console.error(
+      "Error: No connection string provided. Set DATA_STORE_URL or use --connection-string."
+    );
+    process.exit(1);
+  }
+  console.log("Introspecting database schema...");
+  const tables = await introspectSchema(connectionString);
+  if (tables.size === 0) {
+    console.log("No tables found in database.");
+    return;
+  }
+  console.log(`Found ${tables.size} table(s): ${Array.from(tables.keys()).join(", ")}`);
+  const typeScript = generateTypeScript(tables);
+  const dir = outputPath.substring(0, outputPath.lastIndexOf("/"));
+  if (dir) {
+    const { mkdirSync } = await import("fs");
+    mkdirSync(dir, { recursive: true });
+  }
+  (0, import_fs.writeFileSync)(outputPath, typeScript, "utf-8");
+  console.log(`Types written to ${outputPath}`);
+}
+main().catch((error) => {
+  console.error("Failed to generate types:", error);
+  process.exit(1);
+});

package/dist/cli/generate-types.mjs

@@ -0,0 +1,151 @@
+#!/usr/bin/env node
+
+// src/cli/generate-types.ts
+import { writeFileSync } from "fs";
+import { Pool } from "@neondatabase/serverless";
+var PG_TYPE_MAP = {
+  text: "string",
+  varchar: "string",
+  "character varying": "string",
+  char: "string",
+  character: "string",
+  uuid: "string",
+  integer: "number",
+  int: "number",
+  smallint: "number",
+  bigint: "string",
+  // bigint as string to avoid precision loss
+  numeric: "string",
+  decimal: "string",
+  real: "number",
+  "double precision": "number",
+  boolean: "boolean",
+  jsonb: "unknown",
+  json: "unknown",
+  "timestamp with time zone": "Date",
+  "timestamp without time zone": "Date",
+  timestamp: "Date",
+  date: "string",
+  time: "string",
+  "time with time zone": "string",
+  "time without time zone": "string",
+  bytea: "Buffer",
+  "ARRAY": "unknown[]"
+};
+function pgTypeToTs(pgType) {
+  return PG_TYPE_MAP[pgType] ?? "unknown";
+}
+function toPascalCase(name) {
+  return name.split("_").map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join("");
+}
+async function introspectSchema(connectionString) {
+  const pool = new Pool({ connectionString });
+  try {
+    const { rows } = await pool.query(`
+      SELECT
+        c.table_name,
+        c.column_name,
+        c.data_type,
+        c.is_nullable,
+        c.column_default
+      FROM information_schema.columns c
+      JOIN information_schema.tables t
+        ON c.table_name = t.table_name AND c.table_schema = t.table_schema
+      WHERE c.table_schema = 'public'
+        AND t.table_type = 'BASE TABLE'
+        AND t.table_name NOT LIKE '_deleted_%'
+      ORDER BY c.table_name, c.ordinal_position
+    `);
+    const tables = /* @__PURE__ */ new Map();
+    for (const row of rows) {
+      if (!tables.has(row.table_name)) {
+        tables.set(row.table_name, []);
+      }
+      tables.get(row.table_name).push(row);
+    }
+    return tables;
+  } finally {
+    await pool.end();
+  }
+}
+function generateTypeScript(tables) {
+  const lines = [
+    "// Auto-generated by @stardeck-customer-apps/data-store-sdk",
+    "// Do not edit manually \u2014 regenerate with: npx stardeck-data-store generate-types",
+    "",
+    'import type { Generated } from "kysely";',
+    ""
+  ];
+  for (const [tableName, columns] of tables) {
+    const interfaceName = toPascalCase(tableName) + "Table";
+    lines.push(`export interface ${interfaceName} {`);
+    for (const col of columns) {
+      const tsType = pgTypeToTs(col.data_type);
+      const isGenerated = col.column_default !== null;
+      const isNullable = col.is_nullable === "YES";
+      let type = tsType;
+      if (isNullable) {
+        type = `${tsType} | null`;
+      }
+      if (isGenerated) {
+        type = `Generated<${type}>`;
+      }
+      lines.push(`  ${col.column_name}: ${type};`);
+    }
+    lines.push("}");
+    lines.push("");
+  }
+  lines.push("export interface DB {");
+  for (const tableName of tables.keys()) {
+    const interfaceName = toPascalCase(tableName) + "Table";
+    lines.push(`  ${tableName}: ${interfaceName};`);
+  }
+  lines.push("}");
+  lines.push("");
+  return lines.join("\n");
+}
+async function main() {
+  const args = process.argv.slice(2);
+  let connectionString = process.env.DATA_STORE_URL;
+  let outputPath = "./src/generated/data-store-types.ts";
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === "--connection-string" && args[i + 1]) {
+      connectionString = args[++i];
+    } else if (args[i] === "--output" && args[i + 1]) {
+      outputPath = args[++i];
+    } else if (args[i] === "--help") {
+      console.log(`Usage: stardeck-data-store generate-types [options]
+
+Options:
+  --connection-string <url>  Postgres connection string (default: DATA_STORE_URL env var)
+  --output <path>            Output file path (default: ./src/generated/data-store-types.ts)
+  --help                     Show this help message`);
+      process.exit(0);
+    }
+  }
+  if (!connectionString) {
+    console.error(
+      "Error: No connection string provided. Set DATA_STORE_URL or use --connection-string."
+    );
+    process.exit(1);
+  }
+  console.log("Introspecting database schema...");
+  const tables = await introspectSchema(connectionString);
+  if (tables.size === 0) {
+    console.log("No tables found in database.");
+    return;
+  }
+  console.log(`Found ${tables.size} table(s): ${Array.from(tables.keys()).join(", ")}`);
+  const typeScript = generateTypeScript(tables);
+  const dir = outputPath.substring(0, outputPath.lastIndexOf("/"));
+  if (dir) {
+    const { mkdirSync } = await import("fs");
+    mkdirSync(dir, { recursive: true });
+  }
+  writeFileSync(outputPath, typeScript, "utf-8");
+  console.log(`Types written to ${outputPath}`);
+}
+main().catch((error) => {
+  console.error("Failed to generate types:", error);
+  process.exit(1);
+});

package/dist/index.d.mts

@@ -0,0 +1,21 @@
+export { C as ColumnDefinition, D as DataStoreClientConfig, F as FilterOperator, L as ListObjectsResult, Q as QueryFilter, b as QueryOptions, c as QueryResult, S as StorageObject, T as TableColumn, a as TableSchema } from './types-CqVD-TLQ.mjs';
+
+declare class DataStoreError extends Error {
+    code: string;
+    statusCode: number;
+    constructor(message: string, code: string, statusCode: number);
+}
+declare class AuthenticationError extends DataStoreError {
+    constructor(message?: string);
+}
+declare class ForbiddenError extends DataStoreError {
+    constructor(message?: string);
+}
+declare class ValidationError extends DataStoreError {
+    constructor(message: string);
+}
+declare class NotFoundError extends DataStoreError {
+    constructor(message?: string);
+}
+
+export { AuthenticationError, DataStoreError, ForbiddenError, NotFoundError, ValidationError };

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+export { C as ColumnDefinition, D as DataStoreClientConfig, F as FilterOperator, L as ListObjectsResult, Q as QueryFilter, b as QueryOptions, c as QueryResult, S as StorageObject, T as TableColumn, a as TableSchema } from './types-CqVD-TLQ.js';
+
+declare class DataStoreError extends Error {
+    code: string;
+    statusCode: number;
+    constructor(message: string, code: string, statusCode: number);
+}
+declare class AuthenticationError extends DataStoreError {
+    constructor(message?: string);
+}
+declare class ForbiddenError extends DataStoreError {
+    constructor(message?: string);
+}
+declare class ValidationError extends DataStoreError {
+    constructor(message: string);
+}
+declare class NotFoundError extends DataStoreError {
+    constructor(message?: string);
+}
+
+export { AuthenticationError, DataStoreError, ForbiddenError, NotFoundError, ValidationError };

package/dist/index.js

@@ -0,0 +1,73 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  AuthenticationError: () => AuthenticationError,
+  DataStoreError: () => DataStoreError,
+  ForbiddenError: () => ForbiddenError,
+  NotFoundError: () => NotFoundError,
+  ValidationError: () => ValidationError
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/errors.ts
+var DataStoreError = class extends Error {
+  code;
+  statusCode;
+  constructor(message, code, statusCode) {
+    super(message);
+    this.name = "DataStoreError";
+    this.code = code;
+    this.statusCode = statusCode;
+  }
+};
+var AuthenticationError = class extends DataStoreError {
+  constructor(message = "Authentication failed") {
+    super(message, "AUTHENTICATION_ERROR", 401);
+    this.name = "AuthenticationError";
+  }
+};
+var ForbiddenError = class extends DataStoreError {
+  constructor(message = "Insufficient access level") {
+    super(message, "FORBIDDEN", 403);
+    this.name = "ForbiddenError";
+  }
+};
+var ValidationError = class extends DataStoreError {
+  constructor(message) {
+    super(message, "VALIDATION_ERROR", 400);
+    this.name = "ValidationError";
+  }
+};
+var NotFoundError = class extends DataStoreError {
+  constructor(message = "Resource not found") {
+    super(message, "NOT_FOUND", 404);
+    this.name = "NotFoundError";
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AuthenticationError,
+  DataStoreError,
+  ForbiddenError,
+  NotFoundError,
+  ValidationError
+});

package/dist/index.mjs

@@ -0,0 +1,14 @@
+import {
+  AuthenticationError,
+  DataStoreError,
+  ForbiddenError,
+  NotFoundError,
+  ValidationError
+} from "./chunk-7YN3WP4H.mjs";
+export {
+  AuthenticationError,
+  DataStoreError,
+  ForbiddenError,
+  NotFoundError,
+  ValidationError
+};

package/dist/server/index.d.mts

@@ -0,0 +1,108 @@
+import { D as DataStoreClientConfig, a as TableSchema, C as ColumnDefinition, b as QueryOptions, c as QueryResult, L as ListObjectsResult } from '../types-CqVD-TLQ.mjs';
+import { KyselyConfig, Kysely } from 'kysely';
+
+/**
+ * Data Store client for server-side use in deployed projects.
+ *
+ * Provides three capabilities:
+ * - Schema management (create/alter tables and columns)
+ * - Dynamic queries (read/write data without generated types)
+ * - Storage operations (upload/download/list files for storage-type stores)
+ *
+ * All operations go through the Stardeck platform API with HMAC authentication.
+ * For type-safe queries, use Kysely with a direct connection string instead.
+ */
+declare class DataStoreClient {
+    private baseUrl;
+    private storeId;
+    private deploymentSecret;
+    private organizationId;
+    private projectId;
+    private deploymentId;
+    private maxRetries;
+    private debug;
+    constructor(config: DataStoreClientConfig);
+    private getEnv;
+    private log;
+    private getAuthHeader;
+    private request;
+    getSchema(): Promise<{
+        tables: TableSchema[];
+    }>;
+    createTable(name: string, columns: ColumnDefinition[]): Promise<{
+        tableName: string;
+    }>;
+    addColumn(tableName: string, column: ColumnDefinition): Promise<{
+        columnName: string;
+    }>;
+    updateColumn(tableName: string, columnName: string, changes: {
+        newName?: string;
+        newType?: string;
+        currentType?: string;
+    }): Promise<{
+        success: boolean;
+    }>;
+    deleteColumn(tableName: string, columnName: string): Promise<{
+        deletedAs: string;
+    }>;
+    query(tableName: string, options?: QueryOptions): Promise<QueryResult>;
+    insert(tableName: string, row: Record<string, unknown>): Promise<{
+        row: Record<string, unknown>;
+    }>;
+    update(tableName: string, primaryKey: Record<string, unknown>, column: string, value: unknown): Promise<{
+        row: Record<string, unknown>;
+    }>;
+    delete(tableName: string, primaryKey: Record<string, unknown>): Promise<{
+        deleted: boolean;
+    }>;
+    listFiles(options?: {
+        prefix?: string;
+        cursor?: string;
+    }): Promise<ListObjectsResult>;
+    getUploadUrl(key: string, contentType: string, size: number): Promise<{
+        uploadUrl: string;
+        key: string;
+    }>;
+    getDownloadUrl(key: string): Promise<{
+        downloadUrl: string;
+    }>;
+    deleteFiles(keys: string[]): Promise<{
+        deleted: number;
+    }>;
+    createFolder(path: string): Promise<{
+        key: string;
+    }>;
+}
+
+declare function signDeploymentRequest(deploymentSecret: string, payload: {
+    organizationId: string;
+    projectId: string;
+    deploymentId: string;
+}): string;
+
+/**
+ * Creates a Kysely instance for direct database access to a data store.
+ * Use this for type-safe queries when you have generated types and a connection string.
+ *
+ * Requires `@neondatabase/serverless` and `kysely-neon` as peer dependencies.
+ *
+ * @example
+ * ```typescript
+ * import { createDataStore } from "@stardeck-customer-apps/data-store-sdk/server";
+ * import type { DB } from "./generated/data-store-types";
+ *
+ * const db = await createDataStore<DB>();
+ *
+ * const users = await db
+ *   .selectFrom("users")
+ *   .where("status", "=", "active")
+ *   .selectAll()
+ *   .execute();
+ * ```
+ */
+declare function createDataStore<DB>(options?: {
+    connectionString?: string;
+    kyselyConfig?: Partial<KyselyConfig>;
+}): Promise<Kysely<DB>>;
+
+export { DataStoreClient, createDataStore, signDeploymentRequest };