astro-tractstack 2.0.0-rc.0

package/templates/src/types/multiTenant.ts

@@ -0,0 +1,77 @@
+export interface TenantProvisioningData {
+  tenantId: string;
+  adminPassword: string;
+  name: string;
+  adminEmail: string;
+  tursoEnabled: boolean;
+  tursoDatabaseURL?: string;
+  tursoAuthToken?: string;
+}
+
+export interface TenantCapacity {
+  available: boolean;
+  currentTenants: number;
+  maxTenants: number;
+  availableSlots: number;
+}
+
+export interface ActivationRequest {
+  token: string;
+}
+
+export interface TenantActivationRequest {
+  token: string;
+}
+
+export interface TenantProvisioningResponse {
+  message: string;
+  token: string;
+}
+
+export interface TenantRegistrationState {
+  tenantId: string;
+  adminPassword: string;
+  confirmPassword: string;
+  name: string;
+  email: string;
+  tursoEnabled: boolean;
+  tursoDatabaseURL: string;
+  tursoAuthToken: string;
+}
+
+export interface TenantValidationErrors {
+  [key: string]: string;
+}
+
+// Validation functions matching backend
+export function validateTenantId(tenantId: string): {
+  valid: boolean;
+  error?: string;
+} {
+  // Must be 3-12 characters
+  if (tenantId.length < 3 || tenantId.length > 12) {
+    return { valid: false, error: 'Tenant ID must be 3-12 characters long' };
+  }
+
+  // Must be lowercase
+  if (tenantId !== tenantId.toLowerCase()) {
+    return { valid: false, error: 'Tenant ID must be lowercase' };
+  }
+
+  // Only alphanumeric and dashes
+  const validPattern = /^[a-z0-9-]+$/;
+  if (!validPattern.test(tenantId)) {
+    return {
+      valid: false,
+      error:
+        'Tenant ID can only contain lowercase letters, numbers, and dashes',
+    };
+  }
+
+  // Cannot be "default" (reserved)
+  if (tenantId === 'default') {
+    return { valid: false, error: "'default' is a reserved tenant ID" };
+  }
+
+  return { valid: true };
+}

package/templates/src/types/nodeProps.ts

@@ -0,0 +1,66 @@
+import { NodesContext } from '@/stores/nodes';
+import type { BrandConfig } from './tractstack';
+import type { Tag } from './compositorTypes';
+
+export interface WidgetProps {
+  nodeId: string;
+  ctx?: NodesContext;
+  hook: string | null;
+  value1: string | null;
+  value2: string | null;
+  value3: string;
+}
+
+export type NodeProps = {
+  nodeId: string;
+  config?: BrandConfig;
+  ctx?: NodesContext;
+  first?: boolean;
+};
+
+export type NodeTagProps = NodeProps & { tagName: keyof JSX.IntrinsicElements };
+
+export type ElementStylesMemory = {
+  [key in Tag]?: {
+    mobile: Record<string, string>;
+    tablet: Record<string, string>;
+    desktop: Record<string, string>;
+  };
+};
+
+export type ParentStylesMemory = {
+  parentClasses: Array<{
+    mobile: Record<string, string>;
+    tablet: Record<string, string>;
+    desktop: Record<string, string>;
+  }>;
+  bgColour: string | null;
+};
+
+export type ButtonStylesMemory = {
+  buttonClasses: Record<string, string[]>;
+  buttonHoverClasses: Record<string, string[]>;
+};
+
+// Image Operations Types (from legacy storykeep.ts)
+export interface PendingImageOperation {
+  type: 'upload' | 'remove' | 'custom';
+  data?: string;
+  path?: string;
+  filename?: string;
+}
+
+export type PendingImageOperationsStore = {
+  [storyFragmentId: string]: PendingImageOperation | null;
+};
+
+// Topics Management Types (from legacy storykeep.ts)
+export interface Topic {
+  id?: string | number;
+  title: string;
+}
+
+export interface StoryFragmentTopicsData {
+  description: string;
+  topics: Topic[];
+}

package/templates/src/types/tractstack.ts

@@ -0,0 +1,445 @@
+// Base component props that all TractStack components should support
+export interface BaseComponentProps {
+  /** Additional CSS classes */
+  class?: string;
+
+  /** Inline styles */
+  style?: React.CSSProperties | string;
+
+  /** Component ID */
+  id?: string;
+}
+
+// HTMX-specific attributes for components
+export interface HTMXAttributes {
+  'hx-get'?: string;
+  'hx-post'?: string;
+  'hx-put'?: string;
+  'hx-delete'?: string;
+  'hx-target'?: string;
+  'hx-swap'?: string;
+  'hx-trigger'?: string;
+  'hx-vals'?: string;
+  'hx-headers'?: string;
+  [key: `hx-${string}`]: string | undefined;
+}
+
+// API Response structure from Go backend
+export interface APIResponse<T = any> {
+  success: boolean;
+  data?: T;
+  error?: string;
+  message?: string;
+  timestamp?: string;
+}
+
+// Content structure from Go backend
+export interface ContentResponse {
+  id: string;
+  title: string;
+  description?: string;
+  html?: string;
+  fragments?: FragmentReference[];
+  metadata?: Record<string, any>;
+}
+
+// Fragment reference
+export interface FragmentReference {
+  id: string;
+  type: string;
+  lazy?: boolean;
+}
+
+// Event types for tracking and analytics
+export interface TractStackEvent {
+  type: string;
+  target?: string;
+  data?: Record<string, any>;
+  timestamp?: number;
+}
+
+// Fragment component props
+export interface FragmentProps
+  extends BaseComponentProps,
+    Partial<HTMXAttributes> {
+  /** Fragment ID */
+  fragmentId?: string;
+
+  /** Whether to load fragment immediately */
+  eager?: boolean;
+
+  /** Fallback content while loading */
+  fallback?: React.ReactNode;
+}
+
+// Utility type for extracting props from Astro components
+export type AstroComponentProps<T> = T extends (props: infer P) => any
+  ? P
+  : never;
+
+export type Theme =
+  | 'light'
+  | 'light-bw'
+  | 'light-bold'
+  | 'dark'
+  | 'dark-bw'
+  | 'dark-bold';
+export const themes: Theme[] = [
+  'light',
+  'light-bw',
+  'light-bold',
+  'dark',
+  'dark-bw',
+  'dark-bold',
+];
+
+export interface Topic {
+  id: number;
+  title: string;
+}
+
+// CodeHook execution data
+export interface CodeHookData {
+  paneId: string;
+  target: string;
+  payload?: Record<string, string>;
+}
+
+export interface MenuLink {
+  name: string;
+  description: string;
+  featured: boolean;
+  actionLisp: string;
+}
+
+export interface MenuNode {
+  id: string;
+  title: string;
+  theme: string;
+  optionsPayload: MenuLink[];
+}
+
+export interface FullContentMapItem {
+  id: string;
+  title: string;
+  slug: string;
+  type: string;
+  // Epinet specific
+  promoted?: boolean;
+  // Menu specific
+  theme?: string;
+  // Resource specific
+  categorySlug?: string;
+  // Pane specific
+  isContext?: boolean;
+  // StoryFragment specific
+  parentId?: string;
+  parentTitle?: string;
+  parentSlug?: string;
+  panes?: string[];
+  socialImagePath?: string;
+  thumbSrc?: string;
+  thumbSrcSet?: string;
+  description?: string;
+  topics?: string[];
+  changed?: string;
+  // Belief specific
+  scale?: string;
+}
+
+export interface BrandConfig {
+  // Core site configuration
+  SITE_INIT: boolean;
+  WORDMARK_MODE: string;
+  OPEN_DEMO: boolean;
+  STYLES_VER: number;
+  HOME_SLUG: string;
+  TRACTSTACK_HOME_SLUG: string;
+  THEME: string; // e.g., "light-bold"
+  BRAND_COLOURS: string; // e.g., "10120d,fcfcfc,f58333,c8df8c,293f58,a7b1b7,393d34,e3e3e3"
+  SOCIALS: string; // e.g., "github|https://github.com/user,twitter|https://twitter.com/user"
+  LOGO: string;
+  WORDMARK: string;
+  FAVICON: string;
+  SITE_URL: string;
+  SLOGAN: string;
+  FOOTER: string;
+  OG: string;
+  OGLOGO: string;
+  OGTITLE: string;
+  OGAUTHOR: string;
+  OGDESC: string;
+  LOGO_BASE64?: string;
+  WORDMARK_BASE64?: string;
+  OG_BASE64?: string;
+  OGLOGO_BASE64?: string;
+  FAVICON_BASE64?: string;
+  GTAG: string;
+  KNOWN_RESOURCES?: KnownResourcesConfig;
+  HAS_AAI: boolean;
+}
+
+export interface BrandConfigState {
+  // Core site configuration
+  siteInit: boolean;
+  wordmarkMode: string;
+  openDemo: boolean;
+  stylesVer: number;
+  homeSlug: string;
+  tractstackHomeSlug: string;
+  theme: string;
+  brandColours: string[]; // ["10120d", "fcfcfc", "f58333", "c8df8c", "293f58", "a7b1b7", "393d34", "e3e3e3"]
+  socials: string[]; // ["github|https://github.com/user", "twitter|https://twitter.com/user"]
+  logo: string;
+  wordmark: string;
+  favicon: string;
+  siteUrl: string;
+  slogan: string;
+  footer: string;
+  og: string;
+  oglogo: string;
+  ogtitle: string;
+  ogauthor: string;
+  ogdesc: string;
+  logoBase64?: string;
+  wordmarkBase64?: string;
+  ogBase64?: string;
+  oglogoBase64?: string;
+  faviconBase64?: string;
+  gtag: string;
+  knownResources: KnownResourcesConfig;
+  hasAAI: boolean;
+}
+
+// Form validation types
+export interface FieldErrors {
+  [key: string]: string;
+}
+
+// Form state management types
+export interface FormStateConfig<T> {
+  initialData: T;
+  validator?: (state: T) => FieldErrors;
+  interceptor?: (newState: T, field: keyof T, value: any) => T;
+  onSave: (data: T) => void;
+}
+
+export interface FormStateReturn<T> {
+  state: T;
+  originalState: T;
+  updateField: (field: keyof T, value: any) => void;
+  save: () => void;
+  cancel: () => void;
+  isDirty: boolean;
+  isValid: boolean;
+  errors: FieldErrors;
+}
+
+export interface AdvancedConfigStatus {
+  tursoConfigured: boolean;
+  tursoTokenSet: boolean;
+  adminPasswordSet: boolean;
+  editorPasswordSet: boolean;
+  aaiAPIKeySet: boolean;
+  tursoEnabled: boolean;
+}
+
+export interface AdvancedConfigState {
+  tursoUrl: string;
+  tursoToken: string;
+  adminPassword: string;
+  editorPassword: string;
+  aaiApiKey: string;
+}
+
+export interface AdvancedConfigUpdateRequest {
+  TURSO_DATABASE_URL?: string;
+  TURSO_AUTH_TOKEN?: string;
+  ADMIN_PASSWORD?: string;
+  EDITOR_PASSWORD?: string;
+  AAI_API_KEY?: string;
+  HOME_SLUG?: string;
+  TRACTSTACK_HOME_SLUG?: string;
+}
+
+export interface MenuNodeState {
+  id: string;
+  title: string;
+  theme: string;
+  menuLinks: MenuLinkState[];
+}
+
+export interface MenuLinkState {
+  name: string;
+  description: string;
+  featured: boolean;
+  actionLisp: string;
+}
+
+interface BaseTarget {
+  name: string;
+  description: string;
+}
+
+interface SimpleTarget extends BaseTarget {
+  subcommands?: never;
+  requiresParam?: never;
+  paramLabel?: never;
+  requiresSecondParam?: never;
+  param2Label?: never;
+  placeholder?: never;
+}
+
+interface SubcommandTarget extends BaseTarget {
+  subcommands: string[];
+  requiresParam?: never;
+  paramLabel?: never;
+  requiresSecondParam?: never;
+  param2Label?: never;
+  placeholder?: never;
+}
+
+interface SingleParamTarget extends BaseTarget {
+  subcommands?: never;
+  requiresParam: true;
+  paramLabel: string;
+  requiresSecondParam?: never;
+  param2Label?: never;
+  requiresThirdParam?: never;
+  param3Label?: never;
+  placeholder?: string;
+}
+
+interface DoubleParamTarget extends BaseTarget {
+  subcommands?: never;
+  requiresParam: true;
+  paramLabel: string;
+  requiresSecondParam: true;
+  param2Label: string;
+  requiresThirdParam?: boolean;
+  param3Label?: string;
+  placeholder?: never;
+}
+
+interface TripleParamTarget extends BaseTarget {
+  subcommands?: never;
+  requiresParam: true;
+  paramLabel: string;
+  requiresSecondParam: true;
+  param2Label: string;
+  requiresThirdParam: true;
+  param3Label: string;
+  placeholder?: never;
+}
+
+type TargetConfig =
+  | SimpleTarget
+  | SubcommandTarget
+  | SingleParamTarget
+  | DoubleParamTarget
+  | TripleParamTarget;
+
+export type GotoTargets = {
+  [key: string]: TargetConfig;
+};
+
+export interface BeliefNode {
+  id: string;
+  title: string;
+  slug: string;
+  scale: string;
+  customValues?: string[];
+}
+
+export interface BeliefNodeState {
+  id: string;
+  title: string;
+  slug: string;
+  scale: string;
+  customValues: string[];
+}
+
+// Known Resources types
+export interface FieldDefinition {
+  type: string;
+  optional: boolean;
+  defaultValue?: any;
+  belongsToCategory?: string;
+  minNumber?: number;
+  maxNumber?: number;
+}
+
+export interface KnownResourcesConfig {
+  [categoryName: string]: {
+    [fieldName: string]: FieldDefinition;
+  };
+}
+
+export interface ResourceConfig {
+  id: string;
+  title: string;
+  slug: string;
+  categorySlug: string;
+  oneliner: string;
+  optionsPayload: Record<string, any>; // Object, not JSON string
+  actionLisp?: string;
+}
+
+export interface ResourceState {
+  id: string;
+  title: string;
+  slug: string;
+  categorySlug: string;
+  oneliner: string;
+  optionsPayload: Record<string, any>;
+  actionLisp?: string;
+}
+
+// Multi-tenant types following backend interfaces
+
+export interface TenantProvisioningData {
+  tenantId: string;
+  adminPassword: string;
+  name: string;
+  email: string;
+  tursoEnabled: boolean;
+  tursoDatabaseURL?: string;
+  tursoAuthToken?: string;
+}
+
+export interface TenantCapacity {
+  currentCount: number;
+  maxTenants: number;
+  available: number;
+  existingTenants: string[];
+}
+
+export interface TenantActivationRequest {
+  token: string;
+}
+
+// Form state for tenant registration
+export interface TenantRegistrationState {
+  tenantId: string;
+  adminPassword: string;
+  name: string;
+  email: string;
+  tursoEnabled: boolean;
+  tursoDatabaseURL: string;
+  tursoAuthToken: string;
+}
+
+export type ArtpacksStore = Record<string, string[]>;
+
+export interface BunnyPlayer {
+  on(event: string, callback: (data: any) => void): void;
+  off(event: string): void;
+  getCurrentTime(callback: (time: number) => void): void;
+  setCurrentTime(time: number): void;
+  pause(): void;
+  call(method: string, ...args: any[]): void;
+}
+
+export interface PlayerJS {
+  Player: new (elementId: string) => BunnyPlayer;
+}

package/templates/src/utils/aai/getTitleSlug.ts

@@ -0,0 +1,72 @@
+import { findUniqueSlug } from '@/utils/helpers';
+
+interface TitleSlugResponse {
+  title: string;
+  slug: string;
+}
+
+export async function getTitleSlug(
+  markdownContent: string,
+  existingSlugs: string[]
+): Promise<TitleSlugResponse | null> {
+  if (
+    !markdownContent ||
+    markdownContent.trim() === '...' ||
+    markdownContent.trim().length === 0
+  ) {
+    return null;
+  }
+
+  try {
+    const backendUrl =
+      import.meta.env.PUBLIC_GO_BACKEND || 'http://localhost:8080';
+    const tenantId = import.meta.env.PUBLIC_TENANTID || 'default';
+
+    const response = await fetch(`${backendUrl}/api/v1/aai/askLemur`, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'X-Tenant-ID': tenantId,
+      },
+      credentials: 'include',
+      body: JSON.stringify({
+        prompt: `Generate a concise title (maximum 40-50 characters) and a URL-friendly slug (lowercase, only letters, numbers, and dashes, no spaces) that captures the essence of this markdown content. Return only a JSON object with "title" and "slug" keys. 
+
+Example response format:
+{
+  "title": "Short Descriptive Title",
+  "slug": "short-descriptive-title"
+}`,
+        input_text: markdownContent,
+        final_model: 'anthropic/claude-3-5-sonnet',
+      }),
+    });
+
+    if (response.ok) {
+      const data = await response.json();
+      if (data.success && data.data?.response) {
+        let titleData;
+        try {
+          if (typeof data.data.response === 'string') {
+            titleData = JSON.parse(data.data.response);
+          } else {
+            titleData = data.data.response;
+          }
+
+          if (titleData.title && titleData.slug) {
+            return {
+              title: findUniqueSlug(titleData.title, existingSlugs),
+              slug: findUniqueSlug(titleData.slug, existingSlugs),
+            };
+          }
+        } catch (parseError) {
+          console.error('Error parsing title data:', parseError);
+        }
+      }
+    }
+  } catch (error) {
+    console.error('Error generating title:', error);
+  }
+
+  return null;
+}