@upstart.gg/sdk 0.0.103 → 0.0.105

package/src/node/cli/types.ts

@@ -1,34 +0,0 @@
-import type { OptionValues } from "commander";
-import type { Logger } from "../shared/logger";
-
-export type CredentialsStore = {
-  access_token: string;
-  token_type: string;
-  expires_in?: number;
-  refresh_token?: string;
-  refresh_token_expires_in?: number;
-  scope?: string;
-  expires_at: number;
-};
-
-export type CommandArgOpts<Opts extends OptionValues = OptionValues> = {
-  args: string[];
-  options: CommonOptions & Opts;
-  logger: Logger;
-};
-
-export type CommonOptions = {
-  logLevel?: "info" | "warn" | "error" | "silent";
-  clearScreen?: boolean;
-  dryRun?: boolean;
-};
-
-export type BuildOptions = {
-  ssr: boolean | "local";
-  clean?: boolean;
-};
-
-export type GenericApiError = {
-  error: string;
-  error_description: string;
-};

package/src/node/cli/utils.ts

@@ -1,20 +0,0 @@
-export function getPackageManager() {
-  // Detect package manager
-  let packageManager: string | undefined;
-  if (process.env.npm_config_user_agent) {
-    const pmPart = process.env.npm_config_user_agent.split(" ")[0];
-    packageManager = pmPart.slice(0, pmPart.lastIndexOf("/"));
-  }
-
-  // Display message
-  if (!packageManager) {
-    console.log("Warning: could not detect package manager");
-    packageManager = "npm";
-  }
-
-  return packageManager;
-}
-
-export function formatAPIError(error: { error: string; error_description?: string }) {
-  return `[${error.error}]${error.error_description ? `: ${error.error_description}` : ""}`;
-}

package/src/node/shared/config.ts

@@ -1,69 +0,0 @@
-import fs from "node:fs";
-import { readFile } from "node:fs/promises";
-import fg from "fast-glob";
-import { type Logger, logger as defaultLogger } from "./logger";
-import { basename, dirname, extname } from "node:path";
-import type { SiteAndPagesConfig } from "~/shared/site";
-
-export async function loadConfigFromJsFile(
-  configPath: string,
-  logger = defaultLogger as Logger,
-): Promise<SiteAndPagesConfig> {
-  if (!fs.existsSync(configPath)) {
-    logger.error(
-      "🔴 No enpage.config.js found!\nYour project must have an enpage.config.js file in the root directory.\n\n",
-    );
-    process.exit(1);
-  }
-  const config = (await import(configPath)) as SiteAndPagesConfig;
-
-  // Parse the readme files fro the same directory as the config file
-  const readmePath = dirname(configPath);
-  const readme: Record<string, string> = {};
-  const readmeFiles = await fg(["README.enpage.md", "README.enpage.*.md"], {
-    cwd: readmePath,
-    onlyFiles: true,
-    absolute: true,
-    caseSensitiveMatch: false,
-  });
-
-  for (const file of readmeFiles) {
-    const base = basename(file, ".md");
-    const ext = extname(base);
-    const language = (ext === ".enpage" ? "en" : ext.substring(1)).toLowerCase();
-    logger.debug(`Found template readme file (${language}): ${basename(file)}`);
-    readme[language] = await readFile(file, "utf-8");
-  }
-
-  return config;
-}
-
-export function loadConfigFromManifestFile(manifestPath: string, logger: Logger): SiteAndPagesConfig {
-  if (!fs.existsSync(manifestPath)) {
-    logger.error("🔴 No enpage.manifest.json found!\nYou may want to 'build' your template.\n\n");
-    process.exit(1);
-  }
-  return JSON.parse(fs.readFileSync(manifestPath, "utf-8"));
-}
-
-export function validateTemplateConfig(config: SiteAndPagesConfig, logger: Logger) {
-  for (const key in config.site.datasources) {
-    if (config.site.datasources[key].provider === "http-json" && !config.site.datasources[key].sampleData) {
-      logger.error(
-        `🔴 Error: Datasource "${key}" is missing sample data - nothing will be rendered during development! Please check your enpage.config.js file and add a "sampleData" key to your ${key} datasource.`,
-      );
-      throw new Error(`Missing sample data for datasource "${key}"`);
-    }
-  }
-
-  // Todo: replace validation from zod to ajv
-  // const validated = manifestSchema.safeParse(config.manifest);
-  // if (!validated.success) {
-  //   logger.error(`🔴 Error: template manifest is invalid. Check your call to defineManifest().\n`);
-  //   const err = fromError(validated.error);
-  //   logger.error(`Hint: ${err.toString()}\n\n`);
-  //   process.exit(1);
-  // }
-
-  return config;
-}

package/src/node/shared/logger.ts

@@ -1,44 +0,0 @@
-import {
-  createLogger as createLoggerBase,
-  type LogLevel,
-  type LogOptions,
-  type Logger as BaseLogger,
-} from "vite";
-// import { version } from "../../../package.json";
-import chalk from "chalk";
-
-const VERSION = 0.1;
-
-type UpstartLoggerLevel = LogLevel | "debug";
-
-export function createLogger(level?: UpstartLoggerLevel, allowClearScreen?: boolean, showVersion = false) {
-  // vite logger does not support "debug" level
-  const logger = createLoggerBase(level === "debug" ? "info" : level, {
-    prefix: "[upstart]",
-    allowClearScreen,
-  });
-
-  if (showVersion) {
-    logger.info(chalk.hex("#7270c6").bold(`🚀 Upstart v${VERSION}\n`));
-  }
-
-  return {
-    ...logger,
-    success: (message: string, options?: LogOptions) => logger.info(chalk.green(message), options),
-    error: (message: string, options?: LogOptions) => logger.error(chalk.red(message), options),
-    warn: (message: string, options?: LogOptions) => logger.warn(chalk.yellow(message), options),
-    warnOnce: (message: string, options?: LogOptions) => logger.warnOnce(chalk.yellow(message), options),
-    debug: (message: string, options?: LogOptions) => {
-      if (level === "debug") {
-        logger.info(chalk.gray(message), options);
-      }
-    },
-  };
-}
-
-export const logger = createLogger();
-
-export type Logger = BaseLogger & {
-  success: (message: string, options?: LogOptions) => void;
-  debug: (message: string, options?: LogOptions) => void;
-};

package/src/shared/ajv.ts

@@ -1,103 +0,0 @@
-import Ajv, { type ErrorObject } from "ajv";
-import addFormats from "ajv-formats";
-import { preset } from "./bricks/props/preset";
-import { background, backgroundColor } from "./bricks/props/background";
-import { containerLayout } from "./bricks/props/container";
-import { basicAlign } from "./bricks/props/align";
-import { hidden } from "./bricks/props/common";
-import { border } from "./bricks/props/border";
-import { padding } from "./bricks/props/padding";
-import { image } from "./bricks/props/image";
-import { color } from "./bricks/props/color";
-import { shadow } from "./bricks/props/effects";
-import { textContent } from "./bricks/props/text";
-import { cssLength } from "./bricks/props/css-length";
-import { urlOrPageId } from "./bricks/props/string";
-
-export type { JSONSchemaType, AnySchemaObject, SchemaObject, JSONType } from "ajv";
-
-export const ajv = new Ajv({
-  useDefaults: true,
-  strictSchema: false,
-  validateSchema: false,
-  coerceTypes: true,
-  allErrors: true,
-  inlineRefs: false,
-});
-
-ajv.addSchema(preset(), "styles:preset");
-ajv.addSchema(background(), "styles:background");
-ajv.addSchema(backgroundColor(), "styles:backgroundColor");
-ajv.addSchema(basicAlign(), "styles:basicAlign");
-ajv.addSchema(containerLayout(), "styles:containerLayout");
-ajv.addSchema(hidden(), "styles:hidden");
-ajv.addSchema(border(), "styles:border");
-ajv.addSchema(padding(), "styles:padding");
-ajv.addSchema(color(), "styles:color");
-ajv.addSchema(shadow(), "styles:shadow");
-ajv.addSchema(cssLength(), "styles:cssLength");
-ajv.addSchema(image(), "assets:image");
-ajv.addSchema(textContent(), "content:textContent");
-ajv.addSchema(urlOrPageId(), "content:urlOrPageId");
-
-export const jsonStringsSupportedFormats = [
-  "date-time",
-  "time",
-  "date",
-  "email",
-  "hostname",
-  "ipv4",
-  "ipv6",
-  "uri",
-  "uri-reference",
-  "uuid",
-  "uri-template",
-  "json-pointer",
-  "relative-json-pointer",
-  "regex",
-] as const;
-
-// Add formats to Ajv
-addFormats(ajv, [...jsonStringsSupportedFormats]);
-
-ajv.addFormat("date-object", {
-  // biome-ignore lint/suspicious/noExplicitAny: <explanation>
-  validate: (data: any) => data instanceof Date && !Number.isNaN(data.getTime()),
-  async: false,
-});
-
-ajv.addFormat("richtext", {
-  validate: (data: string) => typeof data === "string",
-  async: false,
-});
-
-ajv.addFormat("markdown", {
-  validate: (data: string) => typeof data === "string",
-  async: false,
-});
-
-ajv.addFormat("multiline", {
-  validate: (data: string) => typeof data === "string",
-  async: false,
-});
-
-ajv.addFormat("password", {
-  validate: (data: string) => typeof data === "string",
-  async: false,
-});
-
-export function serializeAjvErrors(errors: ErrorObject[] | null | undefined): string {
-  if (!errors || errors.length === 0) {
-    return "Unknown validation error";
-  }
-  return errors
-    .map((error) => {
-      const { instancePath, message, params } = error;
-      const path = instancePath || "root";
-      const details = Object.entries(params || {})
-        .map(([key, value]) => `${key}: ${value}`)
-        .join(", ");
-      return `${path} ${message} (${details})`;
-    })
-    .join("; ");
-}

package/src/shared/analytics/init.ts

@@ -1,14 +0,0 @@
-export function init() {
-  window.upstartQueue = window.upstartQueue || [];
-  document.addEventListener("visibilitychange", function logData() {
-    if (document.visibilityState === "hidden") {
-      const payload = JSON.stringify(window.upstartQueue);
-      if (navigator.sendBeacon?.(window.location.pathname, payload)) {
-        console.debug("beacon sent", payload);
-        window.upstartQueue = [];
-      } else {
-        console.debug("beacon failed", payload);
-      }
-    }
-  });
-}

package/src/shared/analytics/track.ts

@@ -1,21 +0,0 @@
-import type { BeaconPayload } from "./types";
-
-export function track(type: BeaconPayload["e"], data: BeaconPayload["d"] = {}) {
-  const payload: BeaconPayload = {
-    e: type,
-    t: Date.now(),
-    d: data,
-  };
-  window.upstartQueue.push(payload);
-}
-
-document.addEventListener(
-  "click",
-  function (e) {
-    const target = e.target as HTMLElement;
-    track("click", {
-      buttonId: target.id,
-    });
-  },
-  true,
-);

package/src/shared/analytics/types.ts

@@ -1,13 +0,0 @@
-type EventType = "click" | "submit" | "custom";
-
-export type BeaconPayload = {
-  e: EventType; // event type
-  t: number; // timestamp
-  d?: Record<string, unknown>; // data
-};
-
-declare global {
-  interface Window {
-    upstartQueue: BeaconPayload[];
-  }
-}

package/src/shared/attributes.ts

@@ -1,211 +0,0 @@
-import { Type, type TProperties, type Static, type TObject } from "@sinclair/typebox";
-import type { JSONSchemaType } from "ajv";
-import { backgroundRef } from "./bricks/props/background";
-import { string } from "./bricks/props/string";
-import { optional } from "./bricks/props/helpers";
-import { boolean } from "./bricks/props/boolean";
-import { datetime } from "./bricks/props/date";
-import { enumProp } from "./bricks/props/enum";
-import { jsonDefault } from "json-schema-default";
-
-export function defineAttributes(attrs: TProperties) {
-  // Attributes starting with "$" are reserved for internal use
-  for (const key in attrs) {
-    if (key.startsWith("$")) {
-      throw new Error(
-        `Attribute names starting with '$' (like "${key}") are reserved for internal use. Please rename it.`,
-      );
-    }
-  }
-  return Type.Object(attrs);
-}
-
-/**
- * Retuns the custom attributes schema merged with the default attributes schema
- */
-export function processAttributesSchema(customAttributes: TObject) {
-  return Type.Composite([customAttributes, defaultAttributesSchema]) as AttributesSchema;
-}
-
-export type { JSONSchemaType };
-
-// Default attributes
-const defaultAttributes = {
-  $pageLanguage: enumProp("Language", "en", {
-    options: [
-      { value: "ar", title: "Arabic" },
-      { value: "zh", title: "Chinese" },
-      { value: "cs", title: "Czech" },
-      { value: "nl", title: "Dutch" },
-      { value: "en", title: "English" },
-      { value: "fr", title: "French" },
-      { value: "de", title: "German" },
-      { value: "he", title: "Hebrew" },
-      { value: "hi", title: "Hindi" },
-      { value: "it", title: "Italian" },
-      { value: "ja", title: "Japanese" },
-      { value: "ko", title: "Korean" },
-      { value: "fa", title: "Persian" },
-      { value: "pl", title: "Polish" },
-      { value: "pt", title: "Portuguese" },
-      { value: "ru", title: "Russian" },
-      { value: "es", title: "Spanish" },
-      { value: "tr", title: "Turkish" },
-      { value: "vi", title: "Vietnamese" },
-    ],
-    "ai:guidelines":
-      "Choose a value based on the site description. If the site is in multiple languages, use 'en'.",
-
-    "ui:group": "meta",
-    "ui:group:title": "Meta tags",
-  }),
-
-  $bodyBackground: optional(
-    backgroundRef({
-      default: {
-        color: "#ffffff",
-      },
-      title: "Body Background",
-      description:
-        "Applies to the body element of the page (while $pageBackground applies to the page container)",
-      "ui:field": "background",
-      // disable for now
-      // "ui:show-img-search": true,
-      "ui:group": "layout",
-      "ui:group:title": "Page Layout",
-      "ui:group:order": 3,
-    }),
-  ),
-
-  $pageBackground: optional(backgroundRef({ title: "Page Background", defaultValue: { color: "base-100" } })),
-
-  $pageOgImage: optional(
-    string("Social share image", "", {
-      description: "Image shown when page is shared on social media",
-      "ai:guidelines": "Don't generate this property/image, it is automatically generated.",
-      "ui:group": "meta",
-      "ui:field": "image",
-    }),
-  ),
-
-  $robotsIndexing: optional(
-    boolean("Allow search engines to index this site", true, {
-      description: "Disabling this will prevent search engines from indexing this site",
-      "ai:guidelines": "Don't generate this property/image, it is automatically generated.",
-      "ui:group": "seo",
-      "ui:group:title": "SEO",
-      "ui:scope": "site",
-    }),
-  ),
-
-  $siteOgImage: optional(
-    string("Social share image", "", {
-      description: "Image shown when this site is shared on social media",
-      "ai:guidelines": "Don't generate this image, it is automatically generated.",
-      "ui:field": "image",
-      "ui:group": "meta",
-      "ui:group:title": "Meta tags",
-      "ui:scope": "site",
-    }),
-  ),
-
-  $pagePath: string("Page path", "/", {
-    description: "The URL path of the page",
-    "ui:group": "location",
-    "ui:group:title": "Location",
-    "ui:field": "path",
-  }),
-
-  $pageTitle: string("Title", "Untitled", {
-    "ui:group": "meta",
-    "ui:group:title": "Meta tags",
-    description: "The title of the page. Appears in the browser tab and search results",
-  }),
-
-  $pageDescription: string("Description", "", {
-    "ui:widget": "textarea",
-    "ui:group": "meta",
-    "ui:group:title": "Meta tags",
-    description: "A short description of the page. Used by search engines",
-    "ui:multiline": true,
-  }),
-
-  $pageKeywords: string("Keywords", "", {
-    "ui:group": "meta",
-    "ui:group:title": "Meta tags",
-    description: "Keywords related to the page. Used by search engines",
-    "ui:multiline": true,
-  }),
-
-  $pageLastUpdated: optional(
-    datetime("Last updated", {
-      "ui:hidden": true,
-      "ai:guidelines": "Don't generate this property.",
-    }),
-  ),
-
-  // --- layout attributes ---
-
-  $siteHeadTags: optional(
-    Type.String({
-      title: "Head tags",
-      description:
-        "Add custom tags to the <head> of your site. Useful for analytics tags, custom scripts, etc.",
-      "ai:guidelines": "Don't include meta tags here, they are automatically generated.",
-      "ui:multiline": true,
-      "ui:textarea-class": "h-40 !font-mono",
-      "ui:placeholder": "<script src='https://example.com/script.js'></script>",
-      "ui:premium": true,
-      "ui:scope": "site",
-      "ui:group": "external-scripts",
-      "ui:group:title": "External scripts",
-    }),
-  ),
-  $siteBodyTags: optional(
-    Type.String({
-      title: "Body tags",
-      description:
-        "Add custom tags to the <body> of your site. Useful for analytics tags, custom scripts, etc.",
-      "ui:multiline": true,
-      "ui:premium": true,
-      "ui:textarea-class": "h-40 !font-mono",
-      "ui:placeholder": "<script src='https://example.com/script.js'></script>",
-      "ui:scope": "site",
-      "ui:group": "external-scripts",
-      "ui:group:title": "External scripts",
-    }),
-  ),
-};
-
-export const defaultAttributesSchema = Type.Object(defaultAttributes, { additionalProperties: true });
-export const siteAttributesSchemaForLLM = Type.Pick(defaultAttributesSchema, [
-  "$bodyBackground",
-  "$pageBackground",
-]);
-export const pageAttributesSchemaForLLM = Type.Pick(defaultAttributesSchema, [
-  "$pageTitle",
-  "$pageDescription",
-  "$pageKeywords",
-  "$pageLanguage",
-  "$pagePath",
-  "$bodyBackground",
-  "$pageBackground",
-]);
-
-export type AttributesSchema = typeof defaultAttributesSchema & Record<string, unknown>;
-
-export type Attributes<T extends Record<string, unknown> = Record<string, unknown>> = Static<
-  typeof defaultAttributesSchema
-> &
-  T;
-
-export function resolveAttributes(
-  customAttrsSchema: TObject = Type.Object({}),
-  data: Record<string, unknown> = {},
-) {
-  // To get default values from the custom attributes schema,
-  const defaultAttrValues = jsonDefault(defaultAttributesSchema) as Attributes<
-    Static<typeof defaultAttributesSchema>
-  >;
-  return { ...defaultAttrValues, ...data } as Attributes<Static<typeof customAttrsSchema>>;
-}

package/src/shared/brick-manifest.ts

@@ -1,110 +0,0 @@
-import type { TObject, TProperties, TArray } from "@sinclair/typebox";
-import type { IconBase } from "react-icons/lib";
-import { getSchemaDefaults } from "./utils/schema";
-
-type BrickKind = "brick" | "widget" | "container";
-
-type BrickManifestProps<BProps extends TProperties, DSSchema extends TObject | TArray<TObject>> = {
-  type: string;
-  kind?: BrickKind;
-  name: string;
-  icon: typeof IconBase;
-  iconClassName?: string;
-  description?: string;
-  minWidth?: {
-    mobile: number;
-    desktop: number;
-  };
-  maxWidth?: {
-    mobile: number;
-    desktop: number;
-  };
-  minHeight?: {
-    mobile: number;
-    desktop: number;
-  };
-  maxHeight?: {
-    mobile: number;
-    desktop: number;
-  };
-  defaultWidth?: {
-    mobile: number;
-    desktop: number;
-  };
-  defaultHeight?: {
-    mobile: number;
-    desktop: number;
-  };
-  props: TObject<BProps>;
-  datasource?: DSSchema;
-  hideInLibrary?: boolean;
-  defaultInspectorTab?: "preset" | "style" | "content";
-  deletable?: boolean;
-  movable?: boolean;
-  repeatable?: boolean;
-  resizable?: boolean;
-  duplicatable?: boolean;
-  isContainer?: boolean;
-  aiInstructions?: string;
-};
-
-export function defineBrickManifest<BProps extends TProperties, DSSchema extends TObject | TArray<TObject>>({
-  props,
-  defaultWidth,
-  defaultHeight,
-  minWidth,
-  minHeight,
-  kind = "brick",
-  isContainer = false,
-  hideInLibrary = false,
-  deletable = true,
-  movable = true,
-  resizable = true,
-  repeatable = false,
-  duplicatable = true,
-  defaultInspectorTab = "preset",
-  icon,
-  datasource,
-  ...rest
-}: BrickManifestProps<BProps, DSSchema>) {
-  return {
-    ...rest,
-    datasource: datasource as DSSchema,
-    icon,
-    props,
-    kind,
-    defaultInspectorTab,
-    hideInLibrary,
-    deletable,
-    movable,
-    resizable,
-    repeatable,
-    duplicatable,
-    isContainer,
-    defaultWidth:
-      defaultWidth ?? minWidth ?? ({ desktop: 8, mobile: -1 } as { desktop: number; mobile: number }),
-    defaultHeight:
-      defaultHeight ?? minHeight ?? ({ desktop: 3, mobile: 3 } as { desktop: number; mobile: number }),
-    minWidth,
-    minHeight,
-  } as const;
-}
-
-export type BrickManifest = ReturnType<typeof defineBrickManifest>;
-
-export function getBrickManifestDefaults<M extends BrickManifest>(manifest: M) {
-  return {
-    ...manifest,
-    props: getSchemaDefaults(manifest.props),
-    // mobileProps: {},
-    ...(manifest.datasource ? { datasource: getSchemaDefaults(manifest.datasource) } : {}),
-    // ...(manifest.datarecord ? { datarecord: Value.Create(manifest.datarecord) } : {}),
-  };
-}
-
-export type BrickDefaults = ReturnType<typeof getBrickManifestDefaults>;
-
-export type BrickConstraints = Pick<
-  BrickManifest,
-  "defaultWidth" | "defaultHeight" | "minWidth" | "minHeight" | "maxWidth" | "resizable" | "movable"
->;