@ryanstark24/sfgraph-core 1.1.0

package/dist/ingest/__tests__/read-only-wrapping.test.js

@@ -0,0 +1,62 @@
+import { ReadOnlyViolationError, asOrgId } from "@ryanstark24/sfgraph-shared";
+import { describe, expect, it } from "vitest";
+import { buildJsforceMock } from "../../extractors/live-org/__tests__/_jsforce-mock.js";
+import { wrapConnectionReadOnly } from "../../extractors/live-org/read-only-proxy.js";
+import { SqliteGraphStore } from "../../storage/sqlite/graph-store.js";
+import { liveIngest } from "../live-ingest.js";
+describe("read-only wrapping (integration)", () => {
+    it("no writes are attempted during a live-ingest run", async () => {
+        const writeCounter = { count: 0 };
+        const conn = buildJsforceMock({
+            writeCounter,
+            toolingQueryResults: {
+                "SELECT Id, Name, Body, NamespacePrefix, LastModifiedDate FROM ApexClass": {
+                    records: [],
+                    done: true,
+                },
+                "SELECT Id, Name, Body, NamespacePrefix, LastModifiedDate, TableEnumOrId FROM ApexTrigger": {
+                    records: [],
+                    done: true,
+                },
+                "SELECT Id, DeveloperName, NamespacePrefix, LastModifiedDate FROM LightningComponentBundle": {
+                    records: [],
+                    done: true,
+                },
+                "SELECT QualifiedApiName, NamespacePrefix, LastModifiedDate FROM EntityDefinition WHERE IsCustomSetting=false AND IsCustomizable=true": { records: [], done: true },
+            },
+            metadataList: {
+                Flow: [],
+                Profile: [],
+                PermissionSet: [],
+                SharingRules: [],
+                NamedCredential: [],
+                ExternalServiceRegistration: [],
+            },
+        });
+        const wrapped = wrapConnectionReadOnly(conn);
+        const graphStore = new SqliteGraphStore({ dbPath: ":memory:" });
+        await graphStore.init();
+        const result = await liveIngest({
+            alias: "ro-test",
+            graphStore,
+            mode: "full",
+            preResolved: {
+                orgId: asOrgId("00Dxx0000000RO_AA"),
+                alias: "ro-test",
+                username: "ro@example.com",
+                instanceUrl: "https://example.my.salesforce.com",
+                apiVersion: "60.0",
+                conn: wrapped,
+            },
+            skipSnapshot: true,
+        });
+        expect(result).toBeDefined();
+        expect(writeCounter.count).toBe(0);
+    });
+    it("wrapped connection throws synchronously on sobject.create({})", () => {
+        const conn = buildJsforceMock();
+        const wrapped = wrapConnectionReadOnly(conn);
+        expect(() => wrapped.sobject("Account").create({})).toThrowError(ReadOnlyViolationError);
+    });
+});
+//# sourceMappingURL=read-only-wrapping.test.js.map

package/dist/ingest/__tests__/read-only-wrapping.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-only-wrapping.test.js","sourceRoot":"","sources":["../../../src/ingest/__tests__/read-only-wrapping.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAC9E,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,sDAAsD,CAAC;AACxF,OAAO,EAAE,sBAAsB,EAAE,MAAM,8CAA8C,CAAC;AACtF,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,QAAQ,CAAC,kCAAkC,EAAE,GAAG,EAAE;IAChD,EAAE,CAAC,kDAAkD,EAAE,KAAK,IAAI,EAAE;QAChE,MAAM,YAAY,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,gBAAgB,CAAC;YAC5B,YAAY;YACZ,mBAAmB,EAAE;gBACnB,yEAAyE,EAAE;oBACzE,OAAO,EAAE,EAAE;oBACX,IAAI,EAAE,IAAI;iBACX;gBACD,0FAA0F,EACxF;oBACE,OAAO,EAAE,EAAE;oBACX,IAAI,EAAE,IAAI;iBACX;gBACH,2FAA2F,EACzF;oBACE,OAAO,EAAE,EAAE;oBACX,IAAI,EAAE,IAAI;iBACX;gBACH,sIAAsI,EACpI,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;aAC9B;YACD,YAAY,EAAE;gBACZ,IAAI,EAAE,EAAE;gBACR,OAAO,EAAE,EAAE;gBACX,aAAa,EAAE,EAAE;gBACjB,YAAY,EAAE,EAAE;gBAChB,eAAe,EAAE,EAAE;gBACnB,2BAA2B,EAAE,EAAE;aAChC;SACF,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;QAE7C,MAAM,UAAU,GAAG,IAAI,gBAAgB,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;QAChE,MAAM,UAAU,CAAC,IAAI,EAAE,CAAC;QAExB,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC;YAC9B,KAAK,EAAE,SAAS;YAChB,UAAU;YACV,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE;gBACX,KAAK,EAAE,OAAO,CAAC,mBAAmB,CAAC;gBACnC,KAAK,EAAE,SAAS;gBAChB,QAAQ,EAAE,gBAAgB;gBAC1B,WAAW,EAAE,mCAAmC;gBAChD,UAAU,EAAE,MAAM;gBAClB,IAAI,EAAE,OAAO;aACd;YACD,YAAY,EAAE,IAAI;SACnB,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,MAAM,IAAI,GAAG,gBAAgB,EAAE,CAAC;QAChC,MAAM,OAAO,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,sBAAsB,CAAC,CAAC;IAC3F,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/ingest/index.d.ts

@@ -0,0 +1,5 @@
+export { liveIngest } from "./live-ingest.js";
+export type { LiveIngestOpts, LiveIngestResult, IngestMode } from "./live-ingest.js";
+export { multiOrgIngest, listAllAuthenticatedOrgs } from "./multi-org.js";
+export type { MultiOrgIngestOpts, MultiOrgIngestEntry, MultiOrgIngestSummary, } from "./multi-org.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/ingest/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ingest/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACrF,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC1E,YAAY,EACV,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,gBAAgB,CAAC"}

package/dist/ingest/index.js

@@ -0,0 +1,3 @@
+export { liveIngest } from "./live-ingest.js";
+export { multiOrgIngest, listAllAuthenticatedOrgs } from "./multi-org.js";
+//# sourceMappingURL=index.js.map

package/dist/ingest/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ingest/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/ingest/live-ingest.d.ts

@@ -0,0 +1,59 @@
+import { type OrgId } from "@ryanstark24/sfgraph-shared";
+import type { Logger } from "@ryanstark24/sfgraph-shared";
+import "../parsers/index.js";
+import { type VectorSink } from "../embedding/index.js";
+import { type ResolveOrgDeps, type ResolvedOrg } from "../extractors/live-org/auth.js";
+import { type OrgCapabilities } from "../extractors/live-org/capabilities.js";
+import type { BetterSqlite3Database, GraphStore } from "../storage/interfaces.js";
+import type { SnapshotStore } from "../storage/interfaces.js";
+export type IngestMode = "full" | "incremental" | "auto";
+export interface LiveIngestOpts {
+    alias: string;
+    mode?: IngestMode;
+    graphStore: GraphStore;
+    snapshotStore?: SnapshotStore;
+    logger?: Logger;
+    /** Skip pre-sync snapshot. Default false. */
+    skipSnapshot?: boolean;
+    /** Snapshot retention in days. Default 30. */
+    snapshotRetentionDays?: number;
+    /** Override @salesforce/core for tests. */
+    resolveDeps?: ResolveOrgDeps;
+    /** Pre-resolved org (test/mock injection). When supplied, resolveOrg is skipped. */
+    preResolved?: ResolvedOrg;
+    /** When provided, analysis tables are populated after merge. */
+    analysisDb?: BetterSqlite3Database;
+    /** When provided, batched embedding vectors are pushed during ingest. */
+    vectorStore?: VectorSink;
+    /**
+     * When true and mode resolves to "full", compute the set of qnames that
+     * existed before the sync but were NOT touched during it, and delete them.
+     * Aborts (no deletions) if any parse errors occurred — preserves the graph
+     * against transient SF API hiccups. No-op in incremental mode (deletions
+     * already surface via SourceMember.IsNameObsolete).
+     */
+    detectDeletions?: boolean;
+    /**
+     * Restrict the ingest to specific source labels (e.g. 'apex',
+     * 'generic:Profile', 'vlocity'). Used by --only and --retry-skipped to
+     * fetch a subset of types without rebuilding the whole graph.
+     */
+    onlyLabels?: Set<string>;
+    /**
+     * Where to persist the skip report at end of run. When set, the report is
+     * written as JSON so --retry-skipped can read it on the next run.
+     */
+    skipReportPath?: string;
+}
+export interface LiveIngestResult {
+    orgId: OrgId;
+    capabilities: OrgCapabilities;
+    mode: IngestMode;
+    membersProcessed: number;
+    parseErrors: number;
+    deletions: number;
+    durationMs: number;
+}
+export declare function liveIngest(opts: LiveIngestOpts): Promise<LiveIngestResult>;
+export declare function rethrowAsIngestError(e: unknown, ctx: string): never;
+//# sourceMappingURL=live-ingest.d.ts.map

package/dist/ingest/live-ingest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-ingest.d.ts","sourceRoot":"","sources":["../../src/ingest/live-ingest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,KAAK,EAAiC,MAAM,6BAA6B,CAAC;AACnG,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAI1D,OAAO,qBAAqB,CAAC;AAE7B,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExE,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,WAAW,EAAc,MAAM,gCAAgC,CAAC;AAEnG,OAAO,EAAE,KAAK,eAAe,EAAqB,MAAM,wCAAwC,CAAC;AAIjG,OAAO,KAAK,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAClF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,aAAa,GAAG,MAAM,CAAC;AAEzD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,UAAU,EAAE,UAAU,CAAC;IACvB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,8CAA8C;IAC9C,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,2CAA2C;IAC3C,WAAW,CAAC,EAAE,cAAc,CAAC;IAC7B,oFAAoF;IACpF,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,gEAAgE;IAChE,UAAU,CAAC,EAAE,qBAAqB,CAAC;IACnC,yEAAyE;IACzE,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;OAIG;IACH,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,KAAK,CAAC;IACb,YAAY,EAAE,eAAe,CAAC;IAC9B,IAAI,EAAE,UAAU,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAmLD,wBAAsB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA4bhF;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,KAAK,CAGnE"}