apify-test-tools 0.9.1-beta.1 → 0.9.1-beta.11

package/dist/test/unit/bin/utils/config/structures/grouped.test.js

@@ -0,0 +1,75 @@
+import { describe, expect, it } from 'vitest';
+import { GROUPED_PARSER } from '../../../../../../bin/utils/config/structures/grouped.js';
+const actor = (fields = {}) => ({
+    folder: 'actors/shopify',
+    actorFullName: 'myteam/shopify',
+    ...fields,
+});
+const group = (fields = {}) => ({
+    actors: [actor()],
+    tokenEnvVar: 'APIFY_TOKEN',
+    ...fields,
+});
+describe('GROUPED_PARSER', () => {
+    it('flattens every group into one list, handing each actor its group’s settings', () => {
+        expect(GROUPED_PARSER.parse({
+            groups: {
+                myteam: {
+                    actors: [actor(), actor({ folder: 'actors/email', actorFullName: 'myteam/email' })],
+                    tokenEnvVar: 'APIFY_TOKEN_MYTEAM',
+                    overrideActorContext: ['packages'],
+                },
+                other: { actors: [actor({ folder: 'actors/x', actorFullName: 'other/x' })], tokenEnvVar: 'TOKEN' },
+            },
+        })).toEqual([
+            {
+                folder: 'actors/shopify',
+                actorFullName: 'myteam/shopify',
+                tokenEnvVar: 'APIFY_TOKEN_MYTEAM',
+                overrideActorContext: ['packages'],
+            },
+            {
+                folder: 'actors/email',
+                actorFullName: 'myteam/email',
+                tokenEnvVar: 'APIFY_TOKEN_MYTEAM',
+                overrideActorContext: ['packages'],
+            },
+            { folder: 'actors/x', actorFullName: 'other/x', tokenEnvVar: 'TOKEN', overrideActorContext: undefined },
+        ]);
+    });
+    it('ignores the group key entirely', () => {
+        expect(GROUPED_PARSER.parse({ groups: { 'not-a-folder-at-all': group() } })).toEqual([
+            { folder: 'actors/shopify', actorFullName: 'myteam/shopify', tokenEnvVar: 'APIFY_TOKEN' },
+        ]);
+    });
+    it('allows actors to override some fields', () => {
+        expect(GROUPED_PARSER.parse({ groups: { myteam: group({ actors: [actor({ tokenEnvVar: 'FROM_ACTOR' })] }) } })).toEqual([{ folder: 'actors/shopify', actorFullName: 'myteam/shopify', tokenEnvVar: 'FROM_ACTOR' }]);
+    });
+    it("returns the entries as written — normalizing is not this layer's job", () => {
+        const raw = actor({ folder: 'actors/shopify/' });
+        expect(GROUPED_PARSER.parse({ groups: { myteam: group({ actors: [raw], overrideActorContext: ['packages/'] }) } })).toEqual([{ ...raw, tokenEnvVar: 'APIFY_TOKEN', overrideActorContext: ['packages/'] }]);
+    });
+    it('rejects a config with no groups (and thus no actors)', () => {
+        expect(() => GROUPED_PARSER.parse({})).toThrow();
+    });
+    it('reports problems from every group at once instead of only the first', () => {
+        const message = (() => {
+            try {
+                GROUPED_PARSER.parse({
+                    groups: {
+                        myteam: { actors: [actor({ folder: 123 })], tokenEnvVar: 'APIFY_TOKEN' },
+                        other: { actors: [actor({ actorFullName: 'nope' })] },
+                    },
+                });
+                throw new Error('Function should have thrown');
+            }
+            catch (err) {
+                return err.message;
+            }
+        })();
+        expect(message).toContain('myteam.actors[0].folder');
+        expect(message).toContain('other.actors[0].actorFullName');
+        expect(message).toContain('other.tokenEnvVar');
+    });
+});
+//# sourceMappingURL=grouped.test.js.map

package/dist/test/unit/bin/utils/config/structures/grouped.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grouped.test.js","sourceRoot":"","sources":["../../../../../../../test/unit/bin/utils/config/structures/grouped.test.ts"],"names":[],"mappings":"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"}

package/dist/test/unit/bin/utils/config/structures/legacy.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=legacy.test.d.ts.map

package/dist/test/unit/bin/utils/config/structures/legacy.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy.test.d.ts","sourceRoot":"","sources":["../../../../../../../test/unit/bin/utils/config/structures/legacy.test.ts"],"names":[],"mappings":""}

package/dist/test/unit/bin/utils/config/structures/legacy.test.js

@@ -0,0 +1,63 @@
+import { describe, expect, it } from 'vitest';
+import { LEGACY_PARSER } from '../../../../../../bin/utils/config/structures/legacy.js';
+const entry = (fields = {}) => ({
+    folder: 'actors/shopify',
+    actorFullName: 'myteam/shopify',
+    tokenEnvVar: 'APIFY_TOKEN',
+    ...fields,
+});
+describe('LEGACY_PARSER', () => {
+    it("returns the entries as written — normalizing is not this layer's job", () => {
+        const raw = entry({ folder: 'actors/shopify/', overrideActorContext: ['packages/'] });
+        expect(LEGACY_PARSER.parse({ actors: [raw] })).toEqual([raw]);
+    });
+    it('drops the "mode" discriminator rather than choking on it', () => {
+        expect(LEGACY_PARSER.parse({ mode: 'legacy', actors: [entry()] })).toEqual([entry()]);
+    });
+    it('rejects a file with no "actors" array', () => {
+        expect(() => LEGACY_PARSER.parse({ notActors: [] })).toThrow(/expected array[\s\S]*at actors/);
+    });
+    it('rejects an empty "actors" array', () => {
+        expect(() => LEGACY_PARSER.parse({ actors: [] })).toThrow(/Too small/);
+    });
+    it.each([
+        ['folder is missing', { folder: undefined }, /at actors\[0\]\.folder/],
+        ['folder is not a string', { folder: 123 }, /at actors\[0\]\.folder/],
+        ['tokenEnvVar is missing', { tokenEnvVar: undefined }, /at actors\[0\]\.tokenEnvVar/],
+        ['overrideActorContext is not an array', { overrideActorContext: 'packages' }, /expected array/],
+        ['overrideActorContext holds non-strings', { overrideActorContext: [123] }, /overrideActorContext\[0\]/],
+    ])('rejects an entry where %s', (_name, fields, expected) => {
+        expect(() => LEGACY_PARSER.parse({ actors: [entry(fields)] })).toThrow(expected);
+    });
+    // The "owner/name" halves are checked against the platform's own username/actor-name rules.
+    it.each([
+        ['no slash', 'shopify-scraper'],
+        ['an empty owner', '/shopify'],
+        ['an empty name', 'myteam/'],
+        ['more than two halves', 'myteam/shopify/extra'],
+    ])('rejects an actorFullName with %s', (_name, actorFullName) => {
+        expect(() => LEGACY_PARSER.parse({ actors: [entry({ actorFullName })] })).toThrow(/at actors\[0\]\.actorFullName/);
+    });
+    // Uppercase owners are legal on the platform; ./base.test.ts covers why that is easy to lose.
+    it.each([['myteam/shopify'], ['my.team/web-scraper'], ['my_team/a1'], ['apify/web-scraper'], ['MyTeam/shopify']])('accepts the actorFullName %s', (actorFullName) => {
+        expect(() => LEGACY_PARSER.parse({ actors: [entry({ actorFullName })] })).not.toThrow();
+    });
+    it('reports every invalid field at once instead of only the first', () => {
+        const message = (() => {
+            try {
+                LEGACY_PARSER.parse({
+                    actors: [{ folder: 123, actorFullName: 'shopify', overrideActorContext: 'nope' }],
+                });
+                throw new Error('Function should have thrown');
+            }
+            catch (err) {
+                return err.message;
+            }
+        })();
+        expect(message).toContain('actors[0].folder');
+        expect(message).toContain('actors[0].actorFullName');
+        expect(message).toContain('actors[0].tokenEnvVar');
+        expect(message).toContain('actors[0].overrideActorContext');
+    });
+});
+//# sourceMappingURL=legacy.test.js.map

package/dist/test/unit/bin/utils/config/structures/legacy.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy.test.js","sourceRoot":"","sources":["../../../../../../../test/unit/bin/utils/config/structures/legacy.test.ts"],"names":[],"mappings":"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"}

package/dist/test/unit/bin/utils/files.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=files.test.d.ts.map

package/dist/test/unit/bin/utils/files.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.test.d.ts","sourceRoot":"","sources":["../../../../../test/unit/bin/utils/files.test.ts"],"names":[],"mappings":""}

package/dist/test/unit/bin/utils/files.test.js

@@ -0,0 +1,117 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { afterEach, describe, expect, it } from 'vitest';
+import { safeReadJsonObjectFile } from '../../../../bin/utils/json-file.js';
+// These tests read real fixture files rather than mocking `node:fs`: the whole point of
+// `safeReadJsonObjectFile` is how it reacts to real stat/readFile outcomes (missing path, directory,
+// symlink, unreadable file), so mocking those away would only assert the mock back to itself.
+const FIXTURE_DIR = fileURLToPath(new URL('../../../fixtures/bin/utils/files/', import.meta.url));
+const fixture = (name) => path.join(FIXTURE_DIR, name);
+const NESTED_FIXTURE = {
+    storages: { datasets: { default: { title: 'Default' } } },
+    overrideActorContext: ['../shared', '.'],
+    changelog: null,
+    nested: [{ deep: [1, 2, { deeper: true }] }],
+};
+describe('safeReadJsonObjectFile', () => {
+    describe('valid JSON objects', () => {
+        it('returns the parsed contents, preserving nested objects, arrays and null values', () => {
+            const result = safeReadJsonObjectFile(fixture('nested.json'));
+            expect(result).toStrictEqual({ success: true, contents: NESTED_FIXTURE });
+        });
+        it('accepts an empty JSON object', () => {
+            const result = safeReadJsonObjectFile(fixture('empty-object.json'));
+            expect(result).toStrictEqual({ success: true, contents: {} });
+        });
+        it('reads files that are not named *.json', () => {
+            const result = safeReadJsonObjectFile(fixture('no-json-extension.actorrc'));
+            expect(result).toStrictEqual({ success: true, contents: { a: 1 } });
+        });
+    });
+    describe('filesystem-level handling', () => {
+        it('fails when the path does not exist', () => {
+            const filePath = fixture('does-not-exist.json');
+            const result = safeReadJsonObjectFile(filePath);
+            expect(result).toMatchObject({
+                success: false,
+                reason: 'unreadable',
+            });
+        });
+        // The fixture is named `directory.json` on purpose — the check is `stat().isFile()`, not the extension.
+        it('fails when the path is a directory', () => {
+            const filePath = fixture('directory.json');
+            const result = safeReadJsonObjectFile(filePath);
+            expect(result).toMatchObject({
+                success: false,
+                reason: 'not-a-file',
+            });
+        });
+        // Regression guard: `lstat` would report the link itself as "not a file" and reject it, even
+        // though `readFile` follows symlinks and would have read the target without complaint.
+        it('follows a symlink to its target file', () => {
+            const result = safeReadJsonObjectFile(fixture('symlink-to-valid.json'));
+            expect(result).toStrictEqual({ success: true, contents: NESTED_FIXTURE });
+        });
+        // Git only tracks the executable bit, so this is the one case whose fixture cannot carry its own
+        // mode — `unreadable.json` is committed readable and stripped of permissions just for this test.
+        describe('unreadable file', () => {
+            const filePath = fixture('unreadable.json');
+            afterEach(async () => fs.chmod(filePath, 0o644));
+            it.runIf(process.getuid?.() !== 0)('fails when the file exists but cannot be read', async () => {
+                await fs.chmod(filePath, 0o000);
+                const result = safeReadJsonObjectFile(filePath);
+                expect(result).toMatchObject({
+                    success: false,
+                    reason: 'unreadable',
+                });
+            });
+        });
+    });
+    describe('JSON that is not an object', () => {
+        it('rejects a JSON array', () => {
+            const filePath = fixture('array.json');
+            const result = safeReadJsonObjectFile(filePath);
+            expect(result).toMatchObject({
+                success: false,
+                reason: 'not-an-object',
+            });
+        });
+        it('rejects JSON null', () => {
+            const filePath = fixture('null.json');
+            const result = safeReadJsonObjectFile(filePath);
+            expect(result).toMatchObject({
+                success: false,
+                reason: 'not-an-object',
+            });
+        });
+        it('rejects a JSON primitive', () => {
+            const filePath = fixture('number.json');
+            const result = safeReadJsonObjectFile(filePath);
+            expect(result).toMatchObject({
+                success: false,
+                reason: 'not-an-object',
+            });
+        });
+    });
+    describe('unparseable files', () => {
+        it('fails on malformed JSON', () => {
+            const filePath = fixture('malformed.json');
+            const result = safeReadJsonObjectFile(filePath);
+            expect(result).toMatchObject({ success: false, reason: 'invalid-json' });
+            expect(result.failure.message).toContain(`Failed to parse ${filePath}`);
+        });
+        it('fails on an empty file', () => {
+            const filePath = fixture('empty.json');
+            const result = safeReadJsonObjectFile(filePath);
+            expect(result).toMatchObject({ success: false, reason: 'invalid-json' });
+            expect(result.failure.message).toContain(`Failed to parse ${filePath}`);
+        });
+        it.fails('reads jsonc', () => {
+            const filePath = fixture('comments.jsonc');
+            const result = safeReadJsonObjectFile(filePath);
+            expect(result).toMatchObject({ success: true, contents: { a: 3 } });
+        });
+    });
+});
+//# sourceMappingURL=files.test.js.map

package/dist/test/unit/bin/utils/files.test.js.map

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

package/dist/test/unit/lib.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=lib.test.d.ts.map

package/dist/test/unit/lib.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lib.test.d.ts","sourceRoot":"","sources":["../../../test/unit/lib.test.ts"],"names":[],"mappings":""}

package/dist/test/unit/lib.test.js

@@ -0,0 +1,37 @@
+import { ApifyClient } from 'apify-client';
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { DEFAULT_TEST_ACTOR_TIMEOUT_SECS } from '../../lib/consts.js';
+import { _private } from '../../lib/lib.js';
+import * as UtilsModule from '../../lib/utils.js';
+const { createStartRunFn } = _private;
+describe('createStartRunFn()', () => {
+    const actorCallMock = vi.fn(async () => Promise.resolve({ id: 'fake-run-id' }));
+    const testContext = { task: {}, annotate: vi.fn() };
+    vi.spyOn(UtilsModule, 'sleep').mockResolvedValue(undefined);
+    beforeEach(vi.clearAllMocks);
+    it('should apply default timeout to actor runs', async () => {
+        // Arrange
+        vi.spyOn(ApifyClient.prototype, 'actor').mockReturnValue({
+            call: actorCallMock,
+            get: vi.fn(async () => ({ defaultRunOptions: {} })),
+        });
+        // Act
+        await createStartRunFn('123', testContext)({ input: {} });
+        // Assert
+        expect(actorCallMock).toHaveBeenCalledTimes(1);
+        expect(actorCallMock).toHaveBeenCalledWith({}, { build: undefined, log: null, timeout: DEFAULT_TEST_ACTOR_TIMEOUT_SECS });
+    });
+    it('should respect the default actor run timeout if less', async () => {
+        // Arrange
+        vi.spyOn(ApifyClient.prototype, 'actor').mockReturnValue({
+            call: actorCallMock,
+            get: vi.fn(async () => ({ defaultRunOptions: { timeoutSecs: 60 } })),
+        });
+        // Act
+        await createStartRunFn('123', testContext)({ input: {} });
+        // Assert
+        expect(actorCallMock).toHaveBeenCalledTimes(1);
+        expect(actorCallMock).toHaveBeenCalledWith({}, { build: undefined, log: null, timeout: 60 });
+    });
+});
+//# sourceMappingURL=lib.test.js.map

package/dist/test/unit/lib.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lib.test.js","sourceRoot":"","sources":["../../../test/unit/lib.test.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9D,OAAO,EAAE,+BAA+B,EAAE,MAAM,qBAAqB,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,KAAK,WAAW,MAAM,oBAAoB,CAAC;AAElD,MAAM,EAAE,gBAAgB,EAAE,GAAG,QAAQ,CAAC;AAEtC,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAChC,MAAM,aAAa,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,aAAa,EAAc,CAAC,CAAC,CAAC;IAC5F,MAAM,WAAW,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,CAAC,EAAE,EAA6B,EAAiB,CAAC;IAE9F,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAE5D,UAAU,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC;IAE7B,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QACxD,UAAU;QAEV,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,eAAe,CAAC;YACrD,IAAI,EAAE,aAAoC;YAC1C,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,iBAAiB,EAAE,EAAE,EAAE,CAAU,CAAuB;SACtE,CAAC,CAAC;QAElB,MAAM;QACN,MAAM,gBAAgB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QAE1D,SAAS;QACT,MAAM,CAAC,aAAa,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAC/C,MAAM,CAAC,aAAa,CAAC,CAAC,oBAAoB,CACtC,EAAE,EACF,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,+BAA+B,EAAE,CAC5E,CAAC;IACN,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QAClE,UAAU;QACV,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,eAAe,CAAC;YACrD,IAAI,EAAE,aAAoC;YAC1C,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,iBAAiB,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,EAAE,CAAU,CAAuB;SACvF,CAAC,CAAC;QAElB,MAAM;QACN,MAAM,gBAAgB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QAE1D,SAAS;QACT,MAAM,CAAC,aAAa,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAC/C,MAAM,CAAC,aAAa,CAAC,CAAC,oBAAoB,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;IACjG,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}