@toolproof-core/schema 1.0.1 → 1.0.3

package/src/generated/types/standalone/Resource_Genesis.js

@@ -1 +1 @@
-export {}
+export {}

package/src/generated/types/standalone/Resource_Job.js

@@ -1 +1 @@
-export {}
+export {}

package/src/generated/types/standalone/Resource_RawStrategy.js

@@ -1 +1 @@
-export {}
+export {}

package/src/generated/types/standalone/Resource_ResourceType.js

@@ -1 +1 @@
-export {}
+export {}

package/src/generated/types/standalone/Resource_RunnableStrategy.js

@@ -1 +1 @@
-export {}
+export {}

package/src/index.ts

@@ -1 +1,93 @@
-export {}
+import { JobStepIdentity, BranchStepIdentity, WhileStepIdentity, ForStepIdentity } from './generated/types/types.js';
+
+// Re-export JSON schemas via .ts shims to avoid .json re-exports in declarations
+export { default as SchemaGenesis } from './generated/schemas/Genesis.js';
+export { default as SchemaJob } from './generated/schemas/standalone/Job.js';
+export { default as SchemaStrategyRun } from './generated/schemas/standalone/StrategyRun.js';
+export { default as ResourceTypeGenesis } from './generated/resources/Genesis.js';
+export { default as dependencies } from './generated/dependencyMap.json';
+// export { default as terminals } from './generated/terminals.json';
+
+export type {
+  Resource_Genesis as Resource_GenesisJson
+} from './generated/types/standalone/Resource_Genesis.js';
+
+// export type {
+//   Resource_ResourceFormat as Resource_ResourceFormatJson
+// } from './generated/types/standalone/Resource_ResourceFormat.js';
+export type {
+  Resource_ResourceType as Resource_ResourceTypeJson
+} from './generated/types/standalone/Resource_ResourceType.js';
+export type {
+  Resource_Job as Resource_JobJson
+} from './generated/types/standalone/Resource_Job.js';
+// export type {
+//   Resource_StatelessStrategy as Resource_StatelessStrategyJson
+// } from './generated/types/standalone/Resource_StatelessStrategy.js';
+export type {
+  Resource_RawStrategy as Resource_RawStrategyJson
+} from './generated/types/standalone/Resource_RawStrategy.js';
+export type {
+  Resource_RunnableStrategy as Resource_RunnableStrategyJson
+} from './generated/types/standalone/Resource_RunnableStrategy.js';
+
+
+export type StepIdentityJson = JobStepIdentity | BranchStepIdentity | WhileStepIdentity | ForStepIdentity;
+
+
+export type {
+  DocumentationFacet as DocumentationFacetJson,
+//   ResourceFormatIdentity as ResourceFormatIdentityJson,
+//   ResourceFormat as ResourceFormatJson,
+  NucleusFacet as NucleusFacetJson,
+//   IdentityProp as IdentityPropJson,
+//   MeritProp as MeritPropJson,
+  ResourceTypeIdentity as ResourceTypeIdentityJson,
+  ResourceType as ResourceTypeJson,
+  ResourceRoleIdentity as ResourceRoleIdentityJson,
+  ResourceRoleValue as ResourceRoleValueJson,
+//   ExecutionIdentity as ExecutionIdentityJson,
+//   Execution as ExecutionJson,
+  Conditional as ConditionalJson,
+  RoleMap as RoleMapJson,
+  Roles as RolesJson,
+//   RoleBindingMap as RoleBindingMapJson,
+  RoleBindings as RoleBindingsJson,
+  ResourceIdentity as ResourceIdentityJson,
+  JobStepIdentity as JobStepIdentityJson,
+  BranchStepIdentity as BranchStepIdentityJson,
+  WhileStepIdentity as WhileStepIdentityJson,
+  ForStepIdentity as ForStepIdentityJson,
+  JobStep as JobStepJson,
+  BranchStep as BranchStepJson,
+  WhileStep as WhileStepJson,
+  ForStep as ForStepJson,
+  StepKind as StepKindJson,
+  Step as StepJson,
+  CreationContext as CreationContextJson,
+  ResourceMissing as ResourceMissingJson,
+//   ResourcePotentialInput as ResourcePotentialInputJson,
+//   ResourcePotentialOutput as ResourcePotentialOutputJson,
+//   ResourceMetaBase as ResourceMetaJson, // ATTENTION: type not generated for ResourceMeta
+  Resource as ResourceJson,
+  StrategyState as StrategyStateJson,
+//   StepsFacetIdentity as StatelessStrategyIdentityJson,
+  StepsFacet as StepsFacetJson,
+//   StatefulStrategyIdentity as StatefulStrategyIdentityJson,
+  RawStrategy as RawStrategyJson,
+  RunnableStrategyIdentity as RunnableStrategyIdentityJson,
+  RunnableStrategyStatus as RunnableStrategyStatusJson,
+  RunnableStrategy as RunnableStrategyJson,
+  RunnableStrategyUpdate as RunnableStrategyUpdateJson,
+  Domain as DomainJson,
+  JobIdentity as JobIdentityJson,
+  Job as JobJson,
+  JsonData as JsonDataJson,
+  StrategyThreadIdentity as StrategyThreadIdentityJson,
+  StrategyThreadMap as StrategyThreadMapJson,
+//   ExecutionSocket as ExecutionSocketJson,
+  Timestamp as TimestampJson,
+  Goal as GoalJson,
+} from './generated/types/types.js';
+
+// export { isResourceRoleIdentityJson, isStrategyThreadIdentityJson } from './identityGuards.js';

package/src/scripts/_lib/config.ts

@@ -1,205 +1,205 @@
-/**
- * Configuration for schema generation scripts
- * All paths are configurable via environment variables
- * Provides sensible defaults for standard project structure
- */
-
-import path from 'path';
-
-/**
- * Get environment variable with optional default
- */
-function getEnv(name: string, defaultValue: string): string {
-  const value = process.env[name];
-  return value || defaultValue;
-}
-
-/**
- * Schema configuration with required environment variables
- */
-export class SchemaConfig {
-  // Base paths
-  private readonly root: string;
-  private readonly sourceDir: string;
-  private readonly sourceFile: string;
-  private readonly normalizedDir: string;
-  private readonly schemasDir: string;
-  private readonly resourcesDir: string;
-  private readonly dependencyMapPath: string;
-  private readonly typesSrcDir: string;
-  private readonly typesDistDir: string;
-
-  // Schema metadata
-  private readonly baseUrl: string;
-  private readonly version: string;
-
-  constructor() {
-    // Environment variables with sensible defaults
-    this.root = getEnv('TP_SCHEMA_ROOT', process.cwd());
-    this.sourceDir = getEnv('TP_SCHEMA_SOURCE_DIR', 'src/');
-    this.sourceFile = getEnv('TP_SCHEMA_SOURCE_FILE', 'Genesis.json');
-    // Intermediate, generated artifact produced by normalizeAnchorsToPointers.
-    // This should NOT live next to the source-of-truth schemas.
-    this.normalizedDir = getEnv('TP_SCHEMA_NORMALIZED_DIR', 'src/generated/normalized');
-    this.schemasDir = getEnv('TP_SCHEMA_SCHEMAS_DIR', 'src/generated/schemas');
-    this.resourcesDir = getEnv('TP_SCHEMA_RESOURCES_DIR', 'src/generated/resources');
-    this.dependencyMapPath = getEnv('TP_SCHEMA_DEPENDENCY_MAP_PATH', 'src/generated/dependencyMap.json');
-    this.typesSrcDir = getEnv('TP_SCHEMA_TYPES_SRC_DIR', 'src/generated/types');
-    this.typesDistDir = getEnv('TP_SCHEMA_TYPES_DIST_DIR', 'dist/generated/types');
-    this.baseUrl = getEnv('TP_SCHEMA_BASE_URL', 'https://schemas.toolproof.com');
-    this.version = getEnv('TP_SCHEMA_VERSION', 'v0');
-  }
-
-  // Path getters
-  getRoot(): string {
-    return this.root;
-  }
-
-  getSourceDir(): string {
-    return path.isAbsolute(this.sourceDir)
-      ? this.sourceDir
-      : path.join(this.root, this.sourceDir);
-  }
-
-  getSourceFile(): string {
-    return this.sourceFile;
-  }
-
-  getSourcePath(): string {
-    return path.join(this.getSourceDir(), this.sourceFile);
-  }
-
-  getNormalizedDir(): string {
-    return path.isAbsolute(this.normalizedDir)
-      ? this.normalizedDir
-      : path.join(this.root, this.normalizedDir);
-  }
-
-  getNormalizedSourceFile(): string {
-    // We keep the same basename (Genesis.json) in the generated folder.
-    // The source-of-truth Genesis.json lives under `TP_SCHEMA_SOURCE_DIR`.
-    // The generated/normalized Genesis.json lives under `TP_SCHEMA_NORMALIZED_DIR`.
-    return this.sourceFile;
-  }
-
-  getNormalizedSourcePath(): string {
-    return path.join(this.getNormalizedDir(), this.getNormalizedSourceFile());
-  }
-
-  getSchemasDir(): string {
-    return path.isAbsolute(this.schemasDir)
-      ? this.schemasDir
-      : path.join(this.root, this.schemasDir);
-  }
-
-  getSchemaPath(filename: string): string {
-    return path.join(this.getSchemasDir(), filename);
-  }
-
-  getSchemasStandaloneDir(): string {
-    return path.join(this.getSchemasDir(), 'standalone');
-  }
-
-  getSchemaStandalonePath(filename: string): string {
-    return path.join(this.getSchemasStandaloneDir(), filename);
-  }
-
-  getTypesSrcDir(): string {
-    return path.isAbsolute(this.typesSrcDir)
-      ? this.typesSrcDir
-      : path.join(this.root, this.typesSrcDir);
-  }
-
-  getTypesDistDir(): string {
-    return path.isAbsolute(this.typesDistDir)
-      ? this.typesDistDir
-      : path.join(this.root, this.typesDistDir);
-  }
-
-  getTypesSrcPath(filename: string): string {
-    return path.join(this.getTypesSrcDir(), filename);
-  }
-
-  getTypesDistPath(filename: string): string {
-    return path.join(this.getTypesDistDir(), filename);
-  }
-
-  getTypesStandaloneSrcDir(): string {
-    return path.join(this.getTypesSrcDir(), 'standalone');
-  }
-
-  getTypesStandaloneDistDir(): string {
-    return path.join(this.getTypesDistDir(), 'standalone');
-  }
-
-  getTypesStandaloneSrcPath(filename: string): string {
-    return path.join(this.getTypesStandaloneSrcDir(), filename);
-  }
-
-  getTypesStandaloneDistPath(filename: string): string {
-    return path.join(this.getTypesStandaloneDistDir(), filename);
-  }
-
-  getResourcesDir(): string {
-    return path.isAbsolute(this.resourcesDir)
-      ? this.resourcesDir
-      : path.join(this.root, this.resourcesDir);
-  }
-
-  getDependencyMapPath(): string {
-    return path.isAbsolute(this.dependencyMapPath)
-      ? this.dependencyMapPath
-      : path.join(this.root, this.dependencyMapPath);
-  }
-
-  // Schema URL methods
-  getBaseUrl(): string {
-    return this.baseUrl;
-  }
-
-  getVersion(): string {
-    return this.version;
-  }
-
-  getSchemaId(schemaName: string): string {
-    return `${this.baseUrl}/${this.version}/${schemaName}.json`;
-  }
-
-  /**
-   * Check if a URL matches the configured schema base URL pattern
-   */
-  isSchemaUrl(url: string): boolean {
-    const baseUrlPattern = this.baseUrl.replace('https://', 'https?://');
-    return new RegExp(`^${baseUrlPattern}/`, 'i').test(url);
-  }
-
-  /**
-   * Extract schema name from URL (removes base URL and version prefix)
-   */
-  extractSchemaName(url: string): string {
-    // Remove base URL
-    let name = url.replace(new RegExp(`^${this.baseUrl}/`, 'i'), '');
-
-    // Remove version prefix (v0/, v1/, etc.)
-    name = name.replace(/^v\d+\//, '');
-
-    // Remove .json extension
-    name = name.replace(/\.json$/, '');
-
-    return name;
-  }
-}
-
-// Singleton instance
-let configInstance: SchemaConfig | null = null;
-
-/**
- * Get the schema configuration singleton
- * Throws error if required environment variables are not set
- */
-export function getConfig(): SchemaConfig {
-  if (!configInstance) {
-    configInstance = new SchemaConfig();
-  }
-  return configInstance;
-}
+/**
+ * Configuration for schema generation scripts
+ * All paths are configurable via environment variables
+ * Provides sensible defaults for standard project structure
+ */
+
+import path from 'path';
+
+/**
+ * Get environment variable with optional default
+ */
+function getEnv(name: string, defaultValue: string): string {
+  const value = process.env[name];
+  return value || defaultValue;
+}
+
+/**
+ * Schema configuration with required environment variables
+ */
+export class SchemaConfig {
+  // Base paths
+  private readonly root: string;
+  private readonly sourceDir: string;
+  private readonly sourceFile: string;
+  private readonly normalizedDir: string;
+  private readonly schemasDir: string;
+  private readonly resourcesDir: string;
+  private readonly dependencyMapPath: string;
+  private readonly typesSrcDir: string;
+  private readonly typesDistDir: string;
+
+  // Schema metadata
+  private readonly baseUrl: string;
+  private readonly version: string;
+
+  constructor() {
+    // Environment variables with sensible defaults
+    this.root = getEnv('TP_SCHEMA_ROOT', process.cwd());
+    this.sourceDir = getEnv('TP_SCHEMA_SOURCE_DIR', 'src/');
+    this.sourceFile = getEnv('TP_SCHEMA_SOURCE_FILE', 'Genesis.json');
+    // Intermediate, generated artifact produced by normalizeAnchorsToPointers.
+    // This should NOT live next to the source-of-truth schemas.
+    this.normalizedDir = getEnv('TP_SCHEMA_NORMALIZED_DIR', 'src/generated/normalized');
+    this.schemasDir = getEnv('TP_SCHEMA_SCHEMAS_DIR', 'src/generated/schemas');
+    this.resourcesDir = getEnv('TP_SCHEMA_RESOURCES_DIR', 'src/generated/resources');
+    this.dependencyMapPath = getEnv('TP_SCHEMA_DEPENDENCY_MAP_PATH', 'src/generated/dependencyMap.json');
+    this.typesSrcDir = getEnv('TP_SCHEMA_TYPES_SRC_DIR', 'src/generated/types');
+    this.typesDistDir = getEnv('TP_SCHEMA_TYPES_DIST_DIR', 'dist/generated/types');
+    this.baseUrl = getEnv('TP_SCHEMA_BASE_URL', 'https://schemas.toolproof.com');
+    this.version = getEnv('TP_SCHEMA_VERSION', 'v0');
+  }
+
+  // Path getters
+  getRoot(): string {
+    return this.root;
+  }
+
+  getSourceDir(): string {
+    return path.isAbsolute(this.sourceDir)
+      ? this.sourceDir
+      : path.join(this.root, this.sourceDir);
+  }
+
+  getSourceFile(): string {
+    return this.sourceFile;
+  }
+
+  getSourcePath(): string {
+    return path.join(this.getSourceDir(), this.sourceFile);
+  }
+
+  getNormalizedDir(): string {
+    return path.isAbsolute(this.normalizedDir)
+      ? this.normalizedDir
+      : path.join(this.root, this.normalizedDir);
+  }
+
+  getNormalizedSourceFile(): string {
+    // We keep the same basename (Genesis.json) in the generated folder.
+    // The source-of-truth Genesis.json lives under `TP_SCHEMA_SOURCE_DIR`.
+    // The generated/normalized Genesis.json lives under `TP_SCHEMA_NORMALIZED_DIR`.
+    return this.sourceFile;
+  }
+
+  getNormalizedSourcePath(): string {
+    return path.join(this.getNormalizedDir(), this.getNormalizedSourceFile());
+  }
+
+  getSchemasDir(): string {
+    return path.isAbsolute(this.schemasDir)
+      ? this.schemasDir
+      : path.join(this.root, this.schemasDir);
+  }
+
+  getSchemaPath(filename: string): string {
+    return path.join(this.getSchemasDir(), filename);
+  }
+
+  getSchemasStandaloneDir(): string {
+    return path.join(this.getSchemasDir(), 'standalone');
+  }
+
+  getSchemaStandalonePath(filename: string): string {
+    return path.join(this.getSchemasStandaloneDir(), filename);
+  }
+
+  getTypesSrcDir(): string {
+    return path.isAbsolute(this.typesSrcDir)
+      ? this.typesSrcDir
+      : path.join(this.root, this.typesSrcDir);
+  }
+
+  getTypesDistDir(): string {
+    return path.isAbsolute(this.typesDistDir)
+      ? this.typesDistDir
+      : path.join(this.root, this.typesDistDir);
+  }
+
+  getTypesSrcPath(filename: string): string {
+    return path.join(this.getTypesSrcDir(), filename);
+  }
+
+  getTypesDistPath(filename: string): string {
+    return path.join(this.getTypesDistDir(), filename);
+  }
+
+  getTypesStandaloneSrcDir(): string {
+    return path.join(this.getTypesSrcDir(), 'standalone');
+  }
+
+  getTypesStandaloneDistDir(): string {
+    return path.join(this.getTypesDistDir(), 'standalone');
+  }
+
+  getTypesStandaloneSrcPath(filename: string): string {
+    return path.join(this.getTypesStandaloneSrcDir(), filename);
+  }
+
+  getTypesStandaloneDistPath(filename: string): string {
+    return path.join(this.getTypesStandaloneDistDir(), filename);
+  }
+
+  getResourcesDir(): string {
+    return path.isAbsolute(this.resourcesDir)
+      ? this.resourcesDir
+      : path.join(this.root, this.resourcesDir);
+  }
+
+  getDependencyMapPath(): string {
+    return path.isAbsolute(this.dependencyMapPath)
+      ? this.dependencyMapPath
+      : path.join(this.root, this.dependencyMapPath);
+  }
+
+  // Schema URL methods
+  getBaseUrl(): string {
+    return this.baseUrl;
+  }
+
+  getVersion(): string {
+    return this.version;
+  }
+
+  getSchemaId(schemaName: string): string {
+    return `${this.baseUrl}/${this.version}/${schemaName}.json`;
+  }
+
+  /**
+   * Check if a URL matches the configured schema base URL pattern
+   */
+  isSchemaUrl(url: string): boolean {
+    const baseUrlPattern = this.baseUrl.replace('https://', 'https?://');
+    return new RegExp(`^${baseUrlPattern}/`, 'i').test(url);
+  }
+
+  /**
+   * Extract schema name from URL (removes base URL and version prefix)
+   */
+  extractSchemaName(url: string): string {
+    // Remove base URL
+    let name = url.replace(new RegExp(`^${this.baseUrl}/`, 'i'), '');
+
+    // Remove version prefix (v0/, v1/, etc.)
+    name = name.replace(/^v\d+\//, '');
+
+    // Remove .json extension
+    name = name.replace(/\.json$/, '');
+
+    return name;
+  }
+}
+
+// Singleton instance
+let configInstance: SchemaConfig | null = null;
+
+/**
+ * Get the schema configuration singleton
+ * Throws error if required environment variables are not set
+ */
+export function getConfig(): SchemaConfig {
+  if (!configInstance) {
+    configInstance = new SchemaConfig();
+  }
+  return configInstance;
+}