@memberjunction/schema-engine 0.0.1 → 5.17.0

package/dist/SoftFKConfigEmitter.js

@@ -0,0 +1,87 @@
+/**
+ * Manages soft PK and FK definitions in the additionalSchemaInfo JSON file.
+ * Mirrors the integration schema-builder's SoftFKConfigEmitter but works
+ * with SchemaEngine's generic TableDefinition types.
+ */
+export class SoftFKConfigEmitter {
+    /**
+     * Parse existing additionalSchemaInfo JSON content.
+     * Returns empty object if content is empty/null.
+     */
+    ParseExistingConfig(jsonContent) {
+        if (!jsonContent || jsonContent.trim() === '') {
+            return {};
+        }
+        return JSON.parse(jsonContent);
+    }
+    /**
+     * Merge new soft FK entries into an existing config.
+     * Deduplicates — won't add the same FK twice.
+     */
+    MergeSchemaConfig(existing, newEntries) {
+        const result = JSON.parse(JSON.stringify(existing));
+        for (const entry of newEntries) {
+            if (!result[entry.SchemaName]) {
+                result[entry.SchemaName] = [];
+            }
+            const schemaEntries = result[entry.SchemaName];
+            let tableEntry = schemaEntries.find(t => t.TableName === entry.TableName);
+            if (!tableEntry) {
+                tableEntry = { TableName: entry.TableName, ForeignKeys: [] };
+                schemaEntries.push(tableEntry);
+            }
+            if (!tableEntry.ForeignKeys) {
+                tableEntry.ForeignKeys = [];
+            }
+            const exists = tableEntry.ForeignKeys.some(fk => fk.FieldName === entry.FieldName &&
+                fk.SchemaName === entry.TargetSchemaName &&
+                fk.RelatedTable === entry.TargetTableName &&
+                fk.RelatedField === entry.TargetFieldName);
+            if (!exists) {
+                tableEntry.ForeignKeys.push({
+                    FieldName: entry.FieldName,
+                    SchemaName: entry.TargetSchemaName,
+                    RelatedTable: entry.TargetTableName,
+                    RelatedField: entry.TargetFieldName,
+                });
+            }
+        }
+        return result;
+    }
+    /**
+     * Add soft PK entries for tables.
+     * Uses SoftPrimaryKeys from TableDefinition.
+     */
+    MergeSoftPKs(existing, tableDefs) {
+        const result = JSON.parse(JSON.stringify(existing));
+        for (const table of tableDefs) {
+            if (!table.SoftPrimaryKeys || table.SoftPrimaryKeys.length === 0)
+                continue;
+            if (!result[table.SchemaName]) {
+                result[table.SchemaName] = [];
+            }
+            const schemaEntries = result[table.SchemaName];
+            let tableEntry = schemaEntries.find(t => t.TableName === table.TableName);
+            if (!tableEntry) {
+                tableEntry = { TableName: table.TableName };
+                schemaEntries.push(tableEntry);
+            }
+            tableEntry.PrimaryKey = table.SoftPrimaryKeys.map(fieldName => ({
+                FieldName: fieldName,
+                Description: `Primary key from source system`,
+            }));
+        }
+        return result;
+    }
+    /**
+     * Produce an EmittedFile with the updated additionalSchemaInfo JSON.
+     */
+    EmitConfigFile(configPath, mergedConfig) {
+        return {
+            FilePath: configPath,
+            Content: JSON.stringify(mergedConfig, null, 4) + '\n',
+            Description: 'Updated additionalSchemaInfo with soft PK and FK definitions',
+        };
+    }
+}
+//# sourceMappingURL=SoftFKConfigEmitter.js.map

package/dist/SoftFKConfigEmitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SoftFKConfigEmitter.js","sourceRoot":"","sources":["../src/SoftFKConfigEmitter.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @memberjunction/schema-engine — Public API
+ *
+ * Generic, platform-aware DDL generation for any MJ consumer.
+ * Import from this package for all schema/DDL operations.
+ */
+export type { DatabasePlatform, SchemaFieldType, TableDefinition, ColumnDefinition, ForeignKeyDefinition, ExistingTableInfo, ExistingColumnInfo, SchemaDiff, ColumnModification, SchemaEvolutionInput, TypeMappingEntry, MigrationOutput, MigrationMetadata, EmittedFile, ValidationResult, } from './interfaces.js';
+export { SchemaEngine } from './SchemaEngine.js';
+export { SchemaValidator } from './SchemaValidator.js';
+export { DDLGenerator, GetDialect, ValidateIdentifier, EscapeSqlString, resolveSqlType } from './DDLGenerator.js';
+/** @deprecated Use GetDialect() instead. */
+export { GetDialect as GetPlatformProvider } from './DDLGenerator.js';
+export { MigrationFileWriter, FormatTimestamp, SanitizeForFileName } from './MigrationFileWriter.js';
+export { SchemaEvolution } from './SchemaEvolution.js';
+export { SoftFKConfigEmitter } from './SoftFKConfigEmitter.js';
+export type { SoftFKEntry } from './SoftFKConfigEmitter.js';
+export { RuntimeSchemaManager, ValidateMigrationSQL, RSUError } from './RuntimeSchemaManager.js';
+export type { RSUPipelineBatchResult, RSUPipelineInput, RSUPipelineResult, RSUPipelineStep, RSUPreviewResult, RSUStatus, SQLValidationResult, IRSUCodeGenRunner, RSUPendingWork, } from './RuntimeSchemaManager.js';
+export { RSUMetrics } from './RSUMetrics.js';
+export type { PipelineRunMetric, RSUMetricsSummary } from './RSUMetrics.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,UAAU,EACV,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,WAAW,EACX,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAElH,4CAA4C;AAC5C,OAAO,EAAE,UAAU,IAAI,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAEtE,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACrG,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,YAAY,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAG5D,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACjG,YAAY,EACV,sBAAsB,EACtB,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,SAAS,EACT,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,GACf,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+/**
+ * @memberjunction/schema-engine — Public API
+ *
+ * Generic, platform-aware DDL generation for any MJ consumer.
+ * Import from this package for all schema/DDL operations.
+ */
+// ─── Core Classes ────────────────────────────────────────────────────
+export { SchemaEngine } from './SchemaEngine.js';
+export { SchemaValidator } from './SchemaValidator.js';
+export { DDLGenerator, GetDialect, ValidateIdentifier, EscapeSqlString, resolveSqlType } from './DDLGenerator.js';
+/** @deprecated Use GetDialect() instead. */
+export { GetDialect as GetPlatformProvider } from './DDLGenerator.js';
+export { MigrationFileWriter, FormatTimestamp, SanitizeForFileName } from './MigrationFileWriter.js';
+export { SchemaEvolution } from './SchemaEvolution.js';
+export { SoftFKConfigEmitter } from './SoftFKConfigEmitter.js';
+// ─── Runtime Schema Manager ─────────────────────────────────────────
+export { RuntimeSchemaManager, ValidateMigrationSQL, RSUError } from './RuntimeSchemaManager.js';
+// ─── Metrics & Observability ────────────────────────────────────────
+export { RSUMetrics } from './RSUMetrics.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAqBH,wEAAwE;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAElH,4CAA4C;AAC5C,OAAO,EAAE,UAAU,IAAI,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAEtE,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACrG,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAG/D,uEAAuE;AACvE,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAajG,uEAAuE;AACvE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/interfaces.d.ts

@@ -0,0 +1,175 @@
+/**
+ * @memberjunction/schema-engine — Shared Interfaces
+ *
+ * Generic, platform-agnostic types for DDL generation.
+ * Any MJ consumer (integrations, AI agents, developers) can use these
+ * to describe tables and let SchemaEngine produce platform-correct SQL.
+ */
+/** Supported database platforms for DDL generation. */
+export type DatabasePlatform = 'sqlserver' | 'postgresql';
+/**
+ * Abstract field types understood by SchemaEngine.
+ * TypeMapper converts these to platform-specific SQL types.
+ */
+export type SchemaFieldType = 'string' | 'text' | 'integer' | 'bigint' | 'decimal' | 'boolean' | 'datetime' | 'date' | 'uuid' | 'json' | 'float' | 'time';
+/**
+ * Platform-agnostic table definition — the universal input for DDL generation.
+ * Any consumer provides this; SchemaEngine produces platform-correct SQL.
+ */
+export interface TableDefinition {
+    /** Target database schema (e.g., "custom", "hubspot", "dbo"). */
+    SchemaName: string;
+    /** SQL table name (e.g., "UD_ProjectMilestones", "HubSpotContacts"). */
+    TableName: string;
+    /** MJ entity display name (e.g., "User: Project Milestones"). */
+    EntityName: string;
+    /** Human-readable description for the table. */
+    Description?: string;
+    /** Column definitions (in order). */
+    Columns: ColumnDefinition[];
+    /**
+     * Column names that form the soft primary key (UNIQUE constraint only).
+     * No DB-level PK is created — the unique constraint serves as the natural key.
+     */
+    SoftPrimaryKeys?: string[];
+    /** Foreign key relationships (soft or hard). */
+    ForeignKeys?: ForeignKeyDefinition[];
+    /**
+     * Additional columns injected by the consumer (e.g., integration sync columns).
+     * SchemaEngine appends these after the user-defined Columns.
+     */
+    AdditionalColumns?: ColumnDefinition[];
+}
+/** Definition of a single column. */
+export interface ColumnDefinition {
+    /** Column name. */
+    Name: string;
+    /**
+     * Abstract type — TypeMapper converts to platform SQL type.
+     * Alternatively, pass a raw SQL type string via RawSqlType.
+     */
+    Type: SchemaFieldType;
+    /**
+     * Optional: override with a raw platform-specific SQL type
+     * (e.g., "NVARCHAR(200)", "INT"). When set, Type is ignored.
+     */
+    RawSqlType?: string;
+    /** Whether the column accepts NULL. */
+    IsNullable: boolean;
+    /** Max length for string types (ignored for non-string types). */
+    MaxLength?: number;
+    /** Precision for decimal types. */
+    Precision?: number;
+    /** Scale for decimal types. */
+    Scale?: number;
+    /** SQL expression for default value (e.g., "'Active'", "GETUTCDATE()"). */
+    DefaultValue?: string;
+    /** Human-readable description (sp_addextendedproperty in SQL Server, COMMENT ON in Postgres). */
+    Description?: string;
+}
+/** A foreign key relationship definition. */
+export interface ForeignKeyDefinition {
+    /** Column in this table that holds the FK value. */
+    ColumnName: string;
+    /** Referenced schema. */
+    ReferencedSchema: string;
+    /** Referenced table name. */
+    ReferencedTable: string;
+    /** Referenced column name (typically "ID"). */
+    ReferencedColumn: string;
+    /**
+     * Whether this is a soft FK (metadata-only, no DB constraint)
+     * or a hard FK (real REFERENCES constraint).
+     */
+    IsSoft: boolean;
+}
+/** Current state of an existing table in the target database. */
+export interface ExistingTableInfo {
+    SchemaName: string;
+    TableName: string;
+    Columns: ExistingColumnInfo[];
+}
+/** Current state of a single column. */
+export interface ExistingColumnInfo {
+    Name: string;
+    SqlType: string;
+    IsNullable: boolean;
+    MaxLength: number | null;
+    Precision: number | null;
+    Scale: number | null;
+}
+/** Result of comparing desired vs existing table state. */
+export interface SchemaDiff {
+    /** Columns in desired that are not in existing — need ALTER TABLE ADD. */
+    AddedColumns: ColumnDefinition[];
+    /** Columns in both with different types/nullability — need ALTER TABLE ALTER. */
+    ModifiedColumns: ColumnModification[];
+    /** Columns in existing that are not in desired — deprecated (no physical drop). */
+    RemovedColumns: string[];
+}
+/** A single column type/nullability change. */
+export interface ColumnModification {
+    ColumnName: string;
+    OldType: string;
+    NewType: string;
+    OldNullable: boolean;
+    NewNullable: boolean;
+}
+/** Input for schema evolution: desired state + existing state. */
+export interface SchemaEvolutionInput {
+    /** The desired table definition. */
+    Desired: TableDefinition;
+    /** Current state of the table in the database. */
+    ExistingTable: ExistingTableInfo;
+}
+/** Maps a generic abstract type to platform-specific SQL types. */
+export interface TypeMappingEntry {
+    /** Abstract type (e.g., "string", "integer"). */
+    SourceType: string;
+    /** SQL Server type template (e.g., "NVARCHAR"). */
+    SqlServerType: string;
+    /** PostgreSQL type template (e.g., "VARCHAR"). */
+    PostgresType: string;
+    /** MJ EntityField.Type value (informational — CodeGen discovers actual type). */
+    MJFieldType: string;
+}
+/** Output from SchemaEngine.GenerateMigration(). */
+export interface MigrationOutput {
+    /** The generated SQL (CREATE TABLE, ALTER TABLE, CREATE SCHEMA, etc.). */
+    SQL: string;
+    /** Suggested migration file name in Flyway format (relative to repo root). */
+    FileName: string;
+    /** Fully-qualified table names affected (e.g., ["hubspot.Contacts"]). */
+    AffectedTables: string[];
+    /** Short human-readable summary for commit messages. */
+    Summary: string;
+}
+/** Metadata embedded in the migration file header comment. */
+export interface MigrationMetadata {
+    /** Consumer name (e.g., "Integration", "Agent", "Custom"). */
+    SourceType: string;
+    /** Object being created/modified (e.g., table name). */
+    ObjectName: string;
+    /** Action description (e.g., "CreateTable", "AlterTable"). */
+    Action: string;
+    /** Who or what generated this migration. */
+    GeneratedBy: string;
+    /** ISO timestamp of generation. */
+    Timestamp: string;
+}
+/** A file produced by SchemaEngine (e.g., migration SQL). */
+export interface EmittedFile {
+    /** Relative path from repo root. */
+    FilePath: string;
+    /** Full file content. */
+    Content: string;
+    /** Human-readable description. */
+    Description: string;
+}
+/** Result of validating a TableDefinition. */
+export interface ValidationResult {
+    Valid: boolean;
+    Errors: string[];
+    Warnings: string[];
+}
+//# sourceMappingURL=interfaces.d.ts.map

package/dist/interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../src/interfaces.ts"],"names":[],"mappings":"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"}

package/dist/interfaces.js

@@ -0,0 +1,9 @@
+/**
+ * @memberjunction/schema-engine — Shared Interfaces
+ *
+ * Generic, platform-agnostic types for DDL generation.
+ * Any MJ consumer (integrations, AI agents, developers) can use these
+ * to describe tables and let SchemaEngine produce platform-correct SQL.
+ */
+export {};
+//# sourceMappingURL=interfaces.js.map

package/dist/interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../src/interfaces.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/utils.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Shared utilities for SchemaEngine — identifier validation and SQL escaping.
+ */
+/** Validates that an identifier contains only safe characters. */
+export declare function ValidateIdentifier(name: string, kind: string): void;
+/** Escapes single quotes in a string for use in SQL string literals. */
+export declare function EscapeSqlString(value: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,kEAAkE;AAClE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAInE;AAED,wEAAwE;AACxE,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAErD"}

package/dist/utils.js

@@ -0,0 +1,16 @@
+/**
+ * Shared utilities for SchemaEngine — identifier validation and SQL escaping.
+ */
+/** Characters allowed in SQL identifiers (schema, table, column names). */
+const IDENTIFIER_RE = /^[A-Za-z_][A-Za-z0-9_]*$/;
+/** Validates that an identifier contains only safe characters. */
+export function ValidateIdentifier(name, kind) {
+    if (!IDENTIFIER_RE.test(name)) {
+        throw new Error(`Invalid ${kind} name "${name}": must match ${IDENTIFIER_RE.source}`);
+    }
+}
+/** Escapes single quotes in a string for use in SQL string literals. */
+export function EscapeSqlString(value) {
+    return value.replace(/'/g, "''");
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,2EAA2E;AAC3E,MAAM,aAAa,GAAG,0BAA0B,CAAC;AAEjD,kEAAkE;AAClE,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,IAAY;IAC3D,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,UAAU,IAAI,iBAAiB,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC;IACxF,CAAC;AACH,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AACnC,CAAC"}

package/package.json

@@ -1,10 +1,34 @@
 {
   "name": "@memberjunction/schema-engine",
-  "version": "0.0.1",
-  "description": "OIDC trusted publishing setup package for @memberjunction/schema-engine",
-  "keywords": [
-    "oidc",
-    "trusted-publishing",
-    "setup"
-  ]
+  "type": "module",
+  "version": "5.17.0",
+  "description": "MemberJunction Schema Engine - generic, platform-aware DDL generation for any MJ consumer (integrations, agents, developers)",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "/dist"
+  ],
+  "scripts": {
+    "build": "tsc && tsc-alias -f",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@memberjunction/global": "5.17.0",
+    "@memberjunction/core": "5.17.0",
+    "@memberjunction/sql-dialect": "5.17.0",
+    "@memberjunction/queue": "5.17.0",
+    "@octokit/rest": "^21.1.1"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3",
+    "tsc-alias": "^1.8.16",
+    "vitest": "^4.0.18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/MemberJunction/MJ"
+  },
+  "author": "MemberJunction.com",
+  "license": "ISC"
 }

package/README.md

@@ -1,45 +0,0 @@
-# @memberjunction/schema-engine
-
-## ⚠️ IMPORTANT NOTICE ⚠️
-
-**This package is created solely for the purpose of setting up OIDC (OpenID Connect) trusted publishing with npm.**
-
-This is **NOT** a functional package and contains **NO** code or functionality beyond the OIDC setup configuration.
-
-## Purpose
-
-This package exists to:
-1. Configure OIDC trusted publishing for the package name `@memberjunction/schema-engine`
-2. Enable secure, token-less publishing from CI/CD workflows
-3. Establish provenance for packages published under this name
-
-## What is OIDC Trusted Publishing?
-
-OIDC trusted publishing allows package maintainers to publish packages directly from their CI/CD workflows without needing to manage npm access tokens. Instead, it uses OpenID Connect to establish trust between the CI/CD provider (like GitHub Actions) and npm.
-
-## Setup Instructions
-
-To properly configure OIDC trusted publishing for this package:
-
-1. Go to [npmjs.com](https://www.npmjs.com/) and navigate to your package settings
-2. Configure the trusted publisher (e.g., GitHub Actions)
-3. Specify the repository and workflow that should be allowed to publish
-4. Use the configured workflow to publish your actual package
-
-## DO NOT USE THIS PACKAGE
-
-This package is a placeholder for OIDC configuration only. It:
-- Contains no executable code
-- Provides no functionality
-- Should not be installed as a dependency
-- Exists only for administrative purposes
-
-## More Information
-
-For more details about npm's trusted publishing feature, see:
-- [npm Trusted Publishing Documentation](https://docs.npmjs.com/generating-provenance-statements)
-- [GitHub Actions OIDC Documentation](https://docs.github.com/en/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect)
-
----
-
-**Maintained for OIDC setup purposes only**