bulkyard 1.0.0

package/lib/core/loader.js

@@ -0,0 +1,59 @@
+export async function loadObject(conn, db, objConfig) {
+    const tableName = objConfig.table ?? objConfig.object;
+    try {
+        if (!db.tableExists(tableName)) {
+            return {
+                object: objConfig.object,
+                table: tableName,
+                totalRecords: 0,
+                successCount: 0,
+                failureCount: 0,
+                success: false,
+                errors: [`Table "${tableName}" does not exist in the database.`],
+            };
+        }
+        const rows = db.readAllRows(tableName);
+        if (rows.length === 0) {
+            return {
+                object: objConfig.object,
+                table: tableName,
+                totalRecords: 0,
+                successCount: 0,
+                failureCount: 0,
+                success: true,
+                errors: [],
+            };
+        }
+        const bulkResult = await conn.bulk2.loadAndWaitForResults({
+            object: objConfig.object,
+            operation: objConfig.operation,
+            input: rows,
+            ...(objConfig.externalIdField ? { externalIdFieldName: objConfig.externalIdField } : {}),
+        });
+        const successCount = bulkResult.successfulResults.length;
+        const failureCount = bulkResult.failedResults.length;
+        const errors = bulkResult.failedResults.map((f) => `${f.sf__Id ?? 'unknown'}: ${f.sf__Error ?? 'unknown error'}`);
+        return {
+            object: objConfig.object,
+            table: tableName,
+            totalRecords: rows.length,
+            successCount,
+            failureCount,
+            success: failureCount === 0,
+            errors,
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            object: objConfig.object,
+            table: tableName,
+            totalRecords: 0,
+            successCount: 0,
+            failureCount: 0,
+            success: false,
+            errors: [message],
+        };
+    }
+}
+//# sourceMappingURL=loader.js.map

package/lib/core/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/core/loader.ts"],"names":[],"mappings":"AAcA,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,IAAgB,EAChB,EAAoB,EACpB,SAA+B;IAE/B,MAAM,SAAS,GAAG,SAAS,CAAC,KAAK,IAAI,SAAS,CAAC,MAAM,CAAC;IACtD,IAAI,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,CAAC;YAC/B,OAAO;gBACL,MAAM,EAAE,SAAS,CAAC,MAAM;gBACxB,KAAK,EAAE,SAAS;gBAChB,YAAY,EAAE,CAAC;gBACf,YAAY,EAAE,CAAC;gBACf,YAAY,EAAE,CAAC;gBACf,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,CAAC,UAAU,SAAS,mCAAmC,CAAC;aACjE,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,EAAE,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QACvC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO;gBACL,MAAM,EAAE,SAAS,CAAC,MAAM;gBACxB,KAAK,EAAE,SAAS;gBAChB,YAAY,EAAE,CAAC;gBACf,YAAY,EAAE,CAAC;gBACf,YAAY,EAAE,CAAC;gBACf,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,EAAE;aACX,CAAC;QACJ,CAAC;QAED,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC;YACxD,MAAM,EAAE,SAAS,CAAC,MAAM;YACxB,SAAS,EAAE,SAAS,CAAC,SAAsD;YAC3E,KAAK,EAAE,IAAqC;YAC5C,GAAG,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,mBAAmB,EAAE,SAAS,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACzF,CAAC,CAAC;QAEH,MAAM,YAAY,GAAG,UAAU,CAAC,iBAAiB,CAAC,MAAM,CAAC;QACzD,MAAM,YAAY,GAAG,UAAU,CAAC,aAAa,CAAC,MAAM,CAAC;QACrD,MAAM,MAAM,GAAG,UAAU,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,IAAI,SAAS,KAAK,CAAC,CAAC,SAAS,IAAI,eAAe,EAAE,CAAC,CAAC;QAElH,OAAO;YACL,MAAM,EAAE,SAAS,CAAC,MAAM;YACxB,KAAK,EAAE,SAAS;YAChB,YAAY,EAAE,IAAI,CAAC,MAAM;YACzB,YAAY;YACZ,YAAY;YACZ,OAAO,EAAE,YAAY,KAAK,CAAC;YAC3B,MAAM;SACP,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO;YACL,MAAM,EAAE,SAAS,CAAC,MAAM;YACxB,KAAK,EAAE,SAAS;YAChB,YAAY,EAAE,CAAC;YACf,YAAY,EAAE,CAAC;YACf,YAAY,EAAE,CAAC;YACf,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,CAAC,OAAO,CAAC;SAClB,CAAC;IACJ,CAAC;AACH,CAAC"}

package/lib/core/type-map.d.ts

@@ -0,0 +1 @@
+export declare function sfTypeToSqlite(sfType: string): string;

package/lib/core/type-map.js

@@ -0,0 +1,32 @@
+const SF_TYPE_TO_SQLITE = {
+    int: 'INTEGER',
+    integer: 'INTEGER',
+    boolean: 'INTEGER',
+    double: 'REAL',
+    currency: 'REAL',
+    percent: 'REAL',
+    long: 'INTEGER',
+    string: 'TEXT',
+    id: 'TEXT',
+    reference: 'TEXT',
+    textarea: 'TEXT',
+    url: 'TEXT',
+    email: 'TEXT',
+    phone: 'TEXT',
+    picklist: 'TEXT',
+    multipicklist: 'TEXT',
+    combobox: 'TEXT',
+    date: 'TEXT',
+    datetime: 'TEXT',
+    time: 'TEXT',
+    encryptedstring: 'TEXT',
+    address: 'TEXT',
+    location: 'TEXT',
+    anytype: 'TEXT',
+    complexvalue: 'TEXT',
+    base64: 'BLOB',
+};
+export function sfTypeToSqlite(sfType) {
+    return SF_TYPE_TO_SQLITE[sfType.toLowerCase()] ?? 'TEXT';
+}
+//# sourceMappingURL=type-map.js.map

package/lib/core/type-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-map.js","sourceRoot":"","sources":["../../src/core/type-map.ts"],"names":[],"mappings":"AAAA,MAAM,iBAAiB,GAA2B;IAChD,GAAG,EAAE,SAAS;IACd,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,MAAM;IACd,QAAQ,EAAE,MAAM;IAChB,OAAO,EAAE,MAAM;IACf,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,MAAM;IACd,EAAE,EAAE,MAAM;IACV,SAAS,EAAE,MAAM;IACjB,QAAQ,EAAE,MAAM;IAChB,GAAG,EAAE,MAAM;IACX,KAAK,EAAE,MAAM;IACb,KAAK,EAAE,MAAM;IACb,QAAQ,EAAE,MAAM;IAChB,aAAa,EAAE,MAAM;IACrB,QAAQ,EAAE,MAAM;IAChB,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,MAAM;IAChB,IAAI,EAAE,MAAM;IACZ,eAAe,EAAE,MAAM;IACvB,OAAO,EAAE,MAAM;IACf,QAAQ,EAAE,MAAM;IAChB,OAAO,EAAE,MAAM;IACf,YAAY,EAAE,MAAM;IACpB,MAAM,EAAE,MAAM;CACf,CAAC;AAEF,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,OAAO,iBAAiB,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,IAAI,MAAM,CAAC;AAC3D,CAAC"}

package/lib/index.d.ts

@@ -0,0 +1,2 @@
+declare const _default: {};
+export default _default;

package/lib/index.js

@@ -0,0 +1,2 @@
+export default {};
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAe,EAAE,CAAC"}

package/messages/bulkyard.extract.md

@@ -0,0 +1,55 @@
+# summary
+
+Extract data from a Salesforce org into a local SQLite database using Bulk API 2.0.
+
+# description
+
+Reads a YAML config file to determine which objects to query, then uses Bulk API 2.0 to extract records and write them to a local SQLite database. Each object is stored in its own table.
+
+Alternatively, use --sobject and --query to extract a single object without a config file.
+
+# examples
+
+- Extract data using a config file:
+
+  <%= config.bin %> <%= command.id %> --target-org myOrg --config-file bulkyard.config.yml
+
+- Extract a single object inline:
+
+  <%= config.bin %> <%= command.id %> --target-org myOrg --sobject Account --query "SELECT Id, Name FROM Account"
+
+- Extract inline with a custom database and table name:
+
+  <%= config.bin %> <%= command.id %> --target-org myOrg -s Account -q "SELECT Id, Name FROM Account" -d my.db -t Account_Backup
+
+# flags.config-file.summary
+
+Path to the YAML config file.
+
+# flags.sobject.summary
+
+Salesforce object API name (e.g. Account, Contact).
+
+# flags.query.summary
+
+SOQL query to execute for extraction.
+
+# flags.database.summary
+
+Path to the SQLite database file.
+
+# flags.table.summary
+
+SQLite table name override (defaults to the object name).
+
+# info.extracting
+
+Extracting %s...
+
+# info.complete
+
+Extraction complete.
+
+# error.objectFailed
+
+Failed to extract %s: %s

package/messages/bulkyard.load.md

@@ -0,0 +1,59 @@
+# summary
+
+Load data from a local SQLite database into a Salesforce org using Bulk API 2.0.
+
+# description
+
+Reads a YAML config file to determine which tables to load, then uses Bulk API 2.0 to insert, update, or upsert records from a local SQLite database into the target Salesforce org.
+
+Alternatively, use --sobject and --operation to load a single object without a config file.
+
+# examples
+
+- Load data using a config file:
+
+  <%= config.bin %> <%= command.id %> --target-org myOrg --config-file bulkyard.config.yml
+
+- Load a single object inline:
+
+  <%= config.bin %> <%= command.id %> --target-org myOrg --sobject Account --operation upsert --external-id-field Id
+
+- Load inline with a custom database and table name:
+
+  <%= config.bin %> <%= command.id %> --target-org myOrg -s Account -p insert -d my.db -t Account_Staging
+
+# flags.config-file.summary
+
+Path to the YAML config file.
+
+# flags.sobject.summary
+
+Salesforce object API name (e.g. Account, Contact).
+
+# flags.operation.summary
+
+Bulk API operation: insert, update, upsert, or delete.
+
+# flags.external-id-field.summary
+
+External ID field for upsert operations.
+
+# flags.database.summary
+
+Path to the SQLite database file.
+
+# flags.table.summary
+
+SQLite table name override (defaults to the object name).
+
+# info.loading
+
+Loading %s...
+
+# info.complete
+
+Load complete.
+
+# error.objectFailed
+
+Failed to load %s: %s