@invect/version-control 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 @robase
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/backend/flow-serializer.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Serializes an InvectDefinition to a readable .flow.ts file.
+ *
+ * The output uses the Option A (declarative) format from the SDK plan:
+ *   defineFlow({ name, nodes: [...], edges: [...] })
+ *
+ * NOTE: This is a standalone serializer — it doesn't depend on the SDK being
+ * implemented yet. It generates the .flow.ts text directly from the definition JSON.
+ * When the SDK ships, this will import the actual helpers instead.
+ */
+export declare function serializeFlowToTs(definition: FlowDefinitionJson, metadata: {
+    name: string;
+    description?: string;
+    tags?: string[];
+}): string;
+interface FlowDefinitionJson {
+    nodes: Array<{
+        id: string;
+        type: string;
+        label?: string;
+        referenceId?: string;
+        position?: {
+            x: number;
+            y: number;
+        };
+        params: Record<string, unknown>;
+        mapper?: Record<string, unknown>;
+    }>;
+    edges: Array<{
+        id: string;
+        source: string;
+        target: string;
+        sourceHandle?: string;
+        targetHandle?: string;
+    }>;
+}
+export {};
+//# sourceMappingURL=flow-serializer.d.ts.map

package/dist/backend/flow-serializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-serializer.d.ts","sourceRoot":"","sources":["../../src/backend/flow-serializer.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,kBAAkB,EAC9B,QAAQ,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GAChE,MAAM,CA0ER;AAMD,UAAU,kBAAkB;IAC1B,KAAK,EAAE,KAAK,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAClC,CAAC,CAAC;IACH,KAAK,EAAE,KAAK,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;QACX,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC,CAAC;CACJ"}

package/dist/backend/git-provider.d.ts

@@ -0,0 +1,77 @@
+/** Result of fetching a file from the remote */
+export interface GitFileContent {
+    content: string;
+    sha: string;
+}
+/** Result of creating/updating a file on the remote */
+export interface GitCommitResult {
+    commitSha: string;
+}
+/** Branch info */
+export interface GitBranchInfo {
+    sha: string;
+}
+/** Pull request / merge request creation options */
+export interface CreatePullRequestOptions {
+    title: string;
+    body: string;
+    head: string;
+    base: string;
+    draft?: boolean;
+}
+/** Pull request / merge request result */
+export interface GitPullRequestResult {
+    number: number;
+    url: string;
+}
+/** Pull request / merge request info */
+export interface GitPullRequestInfo {
+    state: 'open' | 'closed' | 'merged';
+    mergedAt?: string;
+}
+/** File update options */
+export interface GitFileUpdateOptions {
+    branch: string;
+    sha?: string;
+}
+/**
+ * Abstraction over a Git hosting provider (GitHub, GitLab, Bitbucket).
+ *
+ * All methods operate on a specific repo (owner/name string).
+ * The provider handles authentication internally.
+ */
+export interface GitProvider {
+    /** Provider identifier, e.g. 'github', 'gitlab', 'bitbucket' */
+    readonly id: string;
+    /** Human-readable name */
+    readonly name: string;
+    /** Get file content at a specific ref (branch/SHA). Returns null if file doesn't exist. */
+    getFileContent(repo: string, path: string, ref?: string): Promise<GitFileContent | null>;
+    /** Create or update a file. If sha is provided, it's an update (must match current SHA for conflict detection). */
+    createOrUpdateFile(repo: string, path: string, content: string, message: string, opts: GitFileUpdateOptions): Promise<GitCommitResult>;
+    /** Delete a file from the repo. */
+    deleteFile(repo: string, path: string, message: string, opts: {
+        branch: string;
+        sha: string;
+    }): Promise<void>;
+    /** Create a new branch from a ref (branch name or SHA). */
+    createBranch(repo: string, branch: string, fromRef: string): Promise<void>;
+    /** Delete a branch. */
+    deleteBranch(repo: string, branch: string): Promise<void>;
+    /** Get branch info. Returns null if branch doesn't exist. */
+    getBranch(repo: string, branch: string): Promise<GitBranchInfo | null>;
+    /** Create a PR/MR. */
+    createPullRequest(repo: string, opts: CreatePullRequestOptions): Promise<GitPullRequestResult>;
+    /** Update an existing PR/MR title/body. */
+    updatePullRequest(repo: string, number: number, opts: {
+        title?: string;
+        body?: string;
+    }): Promise<void>;
+    /** Get PR/MR status. */
+    getPullRequest(repo: string, number: number): Promise<GitPullRequestInfo>;
+    /** Close a PR/MR with an optional comment. */
+    closePullRequest(repo: string, number: number, comment?: string): Promise<void>;
+    /** Verify a webhook signature. Returns true if valid. */
+    verifyWebhookSignature(payload: string, signature: string, secret: string): boolean;
+}
+//# sourceMappingURL=git-provider.d.ts.map

package/dist/backend/git-provider.d.ts.map

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

package/dist/backend/github-provider.d.ts

@@ -0,0 +1,14 @@
+import type { GitProvider } from './git-provider';
+import type { GitProviderAuth } from '../shared/types';
+interface GitHubProviderOptions {
+    auth: GitProviderAuth;
+}
+/**
+ * Create a GitHub provider instance.
+ *
+ * Uses the GitHub REST API directly (no Octokit dependency).
+ * Supports PAT, GitHub App, and Invect credential-based auth.
+ */
+export declare function githubProvider(options: GitHubProviderOptions): GitProvider;
+export {};
+//# sourceMappingURL=github-provider.d.ts.map

package/dist/backend/github-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-provider.d.ts","sourceRoot":"","sources":["../../src/backend/github-provider.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAMV,WAAW,EAGZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,UAAU,qBAAqB;IAC7B,IAAI,EAAE,eAAe,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,WAAW,CA0S1E"}