@fakeware/core 0.0.6 → 0.0.8

package/dist/config/index.d.mts

@@ -1,2 +1,2 @@
-import { a as interpolate, c as FakewareConfigFn, d as FakewareUserConfig, f as fakewareConfigSchema, i as loadConfig, l as defineConfig, n as LoadConfigOptions, o as ConfigError, p as shopwareSchema, r as LoadedConfig, s as ConfigEnv, t as DEFAULT_CONFIG_FILENAME, u as FakewareConfig } from "../index-Dpb1t7ns.mjs";
-export { type ConfigEnv, ConfigError, DEFAULT_CONFIG_FILENAME, type FakewareConfig, type FakewareConfigFn, type FakewareUserConfig, type LoadConfigOptions, type LoadedConfig, defineConfig, fakewareConfigSchema, interpolate, loadConfig, shopwareSchema };
+import { a as interpolate, c as FakewareConfigFn, d as FakewareUserConfig, f as TransactionConfig, h as transactionSchema, i as loadConfig, l as defineConfig, m as shopwareSchema, n as LoadConfigOptions, o as ConfigError, p as fakewareConfigSchema, r as LoadedConfig, s as ConfigEnv, t as DEFAULT_CONFIG_FILENAME, u as FakewareConfig } from "../index-jYm7NShY.mjs";
+export { type ConfigEnv, ConfigError, DEFAULT_CONFIG_FILENAME, type FakewareConfig, type FakewareConfigFn, type FakewareUserConfig, type LoadConfigOptions, type LoadedConfig, type TransactionConfig, defineConfig, fakewareConfigSchema, interpolate, loadConfig, shopwareSchema, transactionSchema };

package/dist/config/index.mjs

@@ -1,2 +1,2 @@
-import { a as interpolate, i as shopwareSchema, n as loadConfig, o as ConfigError, r as fakewareConfigSchema, s as defineConfig, t as DEFAULT_CONFIG_FILENAME } from "../config-CSPA4Itj.mjs";
-export { ConfigError, DEFAULT_CONFIG_FILENAME, defineConfig, fakewareConfigSchema, interpolate, loadConfig, shopwareSchema };
+import { a as transactionSchema, c as defineConfig, i as shopwareSchema, n as loadConfig, o as interpolate, r as fakewareConfigSchema, s as ConfigError, t as DEFAULT_CONFIG_FILENAME } from "../config-K2mtOgJS.mjs";
+export { ConfigError, DEFAULT_CONFIG_FILENAME, defineConfig, fakewareConfigSchema, interpolate, loadConfig, shopwareSchema, transactionSchema };

package/dist/config-K2mtOgJS.mjs

@@ -0,0 +1,308 @@
+import { createHash } from "node:crypto";
+import { access, readFile } from "node:fs/promises";
+import { dirname, isAbsolute, join, resolve } from "node:path";
+import { createJiti } from "jiti";
+import { z } from "zod";
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+//#endregion
+//#region src/define/errors.ts
+var RefError = class extends Error {};
+//#endregion
+//#region src/define/is-plain-object.ts
+function isPlainObject(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value) && !(value instanceof Date);
+}
+//#endregion
+//#region src/define/ids.ts
+const FAKEWARE_NAMESPACE = "b1e0a3f4-6c2d-5a8b-9e7f-0d1c2b3a4e5f";
+function uuidBytes(uuid) {
+	const hex = uuid.replace(/-/g, "");
+	const bytes = new Uint8Array(16);
+	for (let i = 0; i < 16; i++) bytes[i] = Number.parseInt(hex.slice(i * 2, i * 2 + 2), 16);
+	return bytes;
+}
+const NAMESPACE_BYTES = uuidBytes(FAKEWARE_NAMESPACE);
+function uuidv5(name) {
+	const hash = createHash("sha1");
+	hash.update(NAMESPACE_BYTES);
+	hash.update(name, "utf8");
+	const bytes = hash.digest().subarray(0, 16);
+	bytes[6] = bytes[6] & 15 | 80;
+	bytes[8] = bytes[8] & 63 | 128;
+	return bytes.toString("hex");
+}
+function deterministicId(entity, key) {
+	return uuidv5(`${entity}:${key}`);
+}
+function canonicalize(value) {
+	if (Array.isArray(value)) return value.map(canonicalize);
+	if (isPlainObject(value)) {
+		const sorted = {};
+		for (const k of Object.keys(value).sort()) sorted[k] = canonicalize(value[k]);
+		return sorted;
+	}
+	return value;
+}
+function recordHash(payload) {
+	return createHash("sha256").update(JSON.stringify(canonicalize(payload))).digest("hex");
+}
+//#endregion
+//#region src/define/registry.ts
+let entries = [];
+function resetRegistry() {
+	entries = [];
+}
+function staticKey(value) {
+	if (typeof value !== "function") {
+		const k = value.$key;
+		if (typeof k === "string") return k;
+	}
+}
+function defineRecords(entity, recordOrRecords) {
+	const list = Array.isArray(recordOrRecords) ? recordOrRecords : [recordOrRecords];
+	for (const value of list) entries.push({
+		entity,
+		key: staticKey(value),
+		value
+	});
+}
+function drain() {
+	const order = [];
+	const byEntity = /* @__PURE__ */ new Map();
+	for (const e of entries) {
+		let bucket = byEntity.get(e.entity);
+		if (!bucket) {
+			bucket = [];
+			byEntity.set(e.entity, bucket);
+			order.push(e.entity);
+		}
+		bucket.push(e);
+	}
+	return order.map((entity) => ({
+		entity,
+		entries: byEntity.get(entity)
+	}));
+}
+function buildRefIndex(drained) {
+	const refIndex = { byEntity: /* @__PURE__ */ new Map() };
+	const ids = /* @__PURE__ */ new Map();
+	for (const { entity, entries: bucket } of drained) {
+		const slot = {
+			byKey: /* @__PURE__ */ new Map(),
+			all: []
+		};
+		refIndex.byEntity.set(entity, slot);
+		bucket.forEach((entry, i) => {
+			const id = deterministicId(entity, entry.key ?? String(i));
+			ids.set(entry, id);
+			slot.all.push(id);
+			if (entry.key) slot.byKey.set(entry.key, id);
+		});
+	}
+	return {
+		refIndex,
+		ids
+	};
+}
+//#endregion
+//#region src/define/define.ts
+function define(entity, records) {
+	defineRecords(entity, records);
+}
+function many(n, fn) {
+	return Array.from({ length: n }, () => fn);
+}
+let active;
+function setActiveRefIndex(refIndex) {
+	active = refIndex;
+}
+function requireActive() {
+	if (!active) throw new RefError("ref()/refs() may only be called while resolving definitions.");
+	return active;
+}
+function ref(path) {
+	const slash = path.indexOf("/");
+	if (slash === -1) throw new RefError(`ref('${path}') must be of the form 'entity/key'.`);
+	const entity = path.slice(0, slash);
+	const key = path.slice(slash + 1);
+	const id = requireActive().byEntity.get(entity)?.byKey.get(key);
+	if (!id) throw new RefError(`ref('${path}') does not match any defined record.`);
+	return id;
+}
+function refs(entity) {
+	const slot = requireActive().byEntity.get(entity);
+	if (!slot) throw new RefError(`refs('${entity}') does not match any defined entity.`);
+	return [...slot.all];
+}
+//#endregion
+//#region src/define/resolve.ts
+function resolveValue(value, ctx) {
+	if (typeof value === "function") return resolveValue(value(ctx), ctx);
+	if (Array.isArray(value)) return value.map((item) => resolveValue(item, ctx));
+	if (isPlainObject(value)) {
+		const out = {};
+		for (const [key, v] of Object.entries(value)) {
+			if (key === "$key") continue;
+			out[key] = resolveValue(v, ctx);
+		}
+		return out;
+	}
+	return value;
+}
+//#endregion
+//#region src/define/index.ts
+var define_exports = /* @__PURE__ */ __exportAll({
+	RefError: () => RefError,
+	buildRefIndex: () => buildRefIndex,
+	define: () => define,
+	deterministicId: () => deterministicId,
+	drain: () => drain,
+	isPlainObject: () => isPlainObject,
+	many: () => many,
+	recordHash: () => recordHash,
+	ref: () => ref,
+	refs: () => refs,
+	resetRegistry: () => resetRegistry,
+	resolveValue: () => resolveValue,
+	setActiveRefIndex: () => setActiveRefIndex
+});
+//#endregion
+//#region src/runtime/load-module.ts
+var LoadModuleError = class extends Error {};
+const jiti = createJiti(import.meta.url, { virtualModules: { "@fakeware/core": define_exports } });
+async function loadModule(absPath) {
+	try {
+		return await jiti.import(absPath);
+	} catch (error) {
+		throw new LoadModuleError(`Could not load ${absPath}: ${error instanceof Error ? error.message : String(error)}`);
+	}
+}
+//#endregion
+//#region src/config/define.ts
+function defineConfig(config) {
+	return config;
+}
+//#endregion
+//#region src/config/errors.ts
+var ConfigError = class extends Error {};
+//#endregion
+//#region src/config/interpolate.ts
+const ENV_REF = /^\$([A-Z0-9_]+)$/;
+function interpolate(value, env) {
+	if (typeof value === "string") {
+		const match = ENV_REF.exec(value);
+		if (!match) return value;
+		const name = match[1];
+		const resolved = env[name];
+		if (resolved === void 0) throw new ConfigError(`Config references $${name}, but it is not set (check your .env).`);
+		return resolved;
+	}
+	if (Array.isArray(value)) return value.map((item) => interpolate(item, env));
+	if (value && typeof value === "object") {
+		const out = {};
+		for (const [k, v] of Object.entries(value)) out[k] = interpolate(v, env);
+		return out;
+	}
+	return value;
+}
+//#endregion
+//#region src/config/schema.ts
+const shopwareSchema = z.object({
+	url: z.string().min(1, "shopware.url is required"),
+	clientId: z.string().min(1, "shopware.clientId is required"),
+	clientSecret: z.string().min(1, "shopware.clientSecret is required")
+});
+const transactionSchema = z.object({
+	onError: z.enum([
+		"rollback",
+		"continue",
+		"stop"
+	]).default("rollback"),
+	atomic: z.boolean().default(true)
+});
+const fakewareConfigSchema = z.object({
+	shopware: shopwareSchema.optional(),
+	transaction: transactionSchema.prefault({})
+});
+//#endregion
+//#region src/config/load.ts
+const DEFAULT_CONFIG_FILENAME = "fakeware.config.ts";
+async function fileExists(path) {
+	try {
+		await access(path);
+		return true;
+	} catch {
+		return false;
+	}
+}
+async function findConfig(cwd) {
+	let dir = cwd;
+	for (;;) {
+		const candidate = join(dir, DEFAULT_CONFIG_FILENAME);
+		if (await fileExists(candidate)) return candidate;
+		const parent = dirname(dir);
+		if (parent === dir) break;
+		dir = parent;
+	}
+	throw new ConfigError(`No ${DEFAULT_CONFIG_FILENAME} found in ${cwd} or any parent directory. Run \`fakeware init\` first.`);
+}
+async function readEnvFile(projectRoot) {
+	const path = join(projectRoot, ".env");
+	if (!await fileExists(path)) return {};
+	const out = {};
+	const contents = await readFile(path, "utf8");
+	for (const raw of contents.split("\n")) {
+		const line = raw.trim();
+		if (!line || line.startsWith("#")) continue;
+		const eq = line.indexOf("=");
+		if (eq === -1) continue;
+		const key = line.slice(0, eq).trim();
+		let val = line.slice(eq + 1).trim();
+		if (val.startsWith("\"") && val.endsWith("\"") || val.startsWith("'") && val.endsWith("'")) val = val.slice(1, -1);
+		out[key] = val;
+	}
+	return out;
+}
+function isConfigFn(value) {
+	return typeof value === "function";
+}
+async function loadConfig(opts = {}) {
+	const cwd = opts.cwd ?? process.cwd();
+	const configPath = opts.configFile ? isAbsolute(opts.configFile) ? opts.configFile : resolve(cwd, opts.configFile) : await findConfig(cwd);
+	const projectRoot = dirname(configPath);
+	const env = {
+		...process.env,
+		...await readEnvFile(projectRoot)
+	};
+	const exported = (await loadModule(configPath)).default;
+	if (exported === void 0) throw new ConfigError(`${configPath} must \`export default defineConfig(...)\`.`);
+	const configEnv = {
+		env,
+		mode: opts.mode ?? "development"
+	};
+	const interpolated = interpolate(isConfigFn(exported) ? exported(configEnv) : exported, env);
+	const parsed = fakewareConfigSchema.safeParse(interpolated);
+	if (!parsed.success) throw new ConfigError(`Invalid config in ${configPath}: ${parsed.error.message}`);
+	const { shopware } = parsed.data;
+	if (!shopware) throw new ConfigError(`No \`shopware\` connection configured in ${configPath}. up/down need a shop to talk to.`);
+	return {
+		config: parsed.data,
+		connection: shopware,
+		configPath,
+		projectRoot
+	};
+}
+//#endregion
+export { RefError as S, buildRefIndex as _, transactionSchema as a, recordHash as b, defineConfig as c, resolveValue as d, define as f, setActiveRefIndex as g, refs as h, shopwareSchema as i, LoadModuleError as l, ref as m, loadConfig as n, interpolate as o, many as p, fakewareConfigSchema as r, ConfigError as s, DEFAULT_CONFIG_FILENAME as t, loadModule as u, drain as v, isPlainObject as x, resetRegistry as y };
+
+//# sourceMappingURL=config-K2mtOgJS.mjs.map

package/dist/config-K2mtOgJS.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-K2mtOgJS.mjs","names":["core"],"sources":["../src/define/errors.ts","../src/define/is-plain-object.ts","../src/define/ids.ts","../src/define/registry.ts","../src/define/define.ts","../src/define/resolve.ts","../src/define/index.ts","../src/runtime/load-module.ts","../src/config/define.ts","../src/config/errors.ts","../src/config/interpolate.ts","../src/config/schema.ts","../src/config/load.ts"],"sourcesContent":["export class RefError extends Error {}\n","export function isPlainObject(value: unknown): value is Record<string, unknown> {\n  return (\n    typeof value === 'object' && value !== null && !Array.isArray(value) && !(value instanceof Date)\n  )\n}\n","import { createHash } from 'node:crypto'\nimport { isPlainObject } from './is-plain-object'\n\nconst FAKEWARE_NAMESPACE = 'b1e0a3f4-6c2d-5a8b-9e7f-0d1c2b3a4e5f'\n\nfunction uuidBytes(uuid: string): Uint8Array {\n  const hex = uuid.replace(/-/g, '')\n  const bytes = new Uint8Array(16)\n  for (let i = 0; i < 16; i++) {\n    bytes[i] = Number.parseInt(hex.slice(i * 2, i * 2 + 2), 16)\n  }\n  return bytes\n}\n\nconst NAMESPACE_BYTES = uuidBytes(FAKEWARE_NAMESPACE)\n\nfunction uuidv5(name: string): string {\n  const hash = createHash('sha1')\n  hash.update(NAMESPACE_BYTES)\n  hash.update(name, 'utf8')\n  const digest = hash.digest()\n\n  const bytes = digest.subarray(0, 16)\n  bytes[6] = ((bytes[6] as number) & 0x0f) | 0x50\n  bytes[8] = ((bytes[8] as number) & 0x3f) | 0x80\n\n  return bytes.toString('hex')\n}\n\nexport function deterministicId(entity: string, key: string): string {\n  return uuidv5(`${entity}:${key}`)\n}\n\nfunction canonicalize(value: unknown): unknown {\n  if (Array.isArray(value)) return value.map(canonicalize)\n  if (isPlainObject(value)) {\n    const sorted: Record<string, unknown> = {}\n    for (const k of Object.keys(value).sort()) {\n      sorted[k] = canonicalize(value[k])\n    }\n    return sorted\n  }\n  return value\n}\n\nexport function recordHash(payload: unknown): string {\n  return createHash('sha256')\n    .update(JSON.stringify(canonicalize(payload)))\n    .digest('hex')\n}\n","import type { Ctx } from './ctx'\nimport { deterministicId } from './ids'\n\ntype RecordObject = Record<string, unknown>\nexport type RecordValue = RecordObject | ((ctx: Ctx) => RecordObject)\n\ninterface RawEntry {\n  entity: string\n  key?: string\n  value: RecordValue\n}\n\nexport type DrainedEntries = { entity: string; entries: RawEntry[] }[]\n\nexport interface RefIndex {\n  byEntity: Map<string, { byKey: Map<string, string>; all: string[] }>\n}\n\nlet entries: RawEntry[] = []\n\nexport function resetRegistry(): void {\n  entries = []\n}\n\nfunction staticKey(value: RecordValue): string | undefined {\n  if (typeof value !== 'function') {\n    const k = (value as RecordObject).$key\n    if (typeof k === 'string') return k\n  }\n  return undefined\n}\n\nexport function defineRecords(entity: string, recordOrRecords: RecordValue | RecordValue[]): void {\n  const list = Array.isArray(recordOrRecords) ? recordOrRecords : [recordOrRecords]\n  for (const value of list) {\n    entries.push({ entity, key: staticKey(value), value })\n  }\n}\n\nexport function drain(): DrainedEntries {\n  const order: string[] = []\n  const byEntity = new Map<string, RawEntry[]>()\n  for (const e of entries) {\n    let bucket = byEntity.get(e.entity)\n    if (!bucket) {\n      bucket = []\n      byEntity.set(e.entity, bucket)\n      order.push(e.entity)\n    }\n    bucket.push(e)\n  }\n  return order.map((entity) => ({ entity, entries: byEntity.get(entity) as RawEntry[] }))\n}\n\nexport function buildRefIndex(drained: DrainedEntries): {\n  refIndex: RefIndex\n  ids: Map<RawEntry, string>\n} {\n  const refIndex: RefIndex = { byEntity: new Map() }\n  const ids = new Map<RawEntry, string>()\n\n  for (const { entity, entries: bucket } of drained) {\n    const slot = { byKey: new Map<string, string>(), all: [] as string[] }\n    refIndex.byEntity.set(entity, slot)\n    bucket.forEach((entry, i) => {\n      const idKey = entry.key ?? String(i)\n      const id = deterministicId(entity, idKey)\n      ids.set(entry, id)\n      slot.all.push(id)\n      if (entry.key) slot.byKey.set(entry.key, id)\n    })\n  }\n\n  return { refIndex, ids }\n}\n\nexport type { RawEntry }\n","import type { Ctx } from './ctx'\nimport { RefError } from './errors'\nimport { defineRecords, type RecordValue, type RefIndex } from './registry'\nimport type { DefineRecord, EntityName } from './schema'\n\nexport function define<const E extends EntityName>(\n  entity: E,\n  records: DefineRecord<E> | readonly DefineRecord<E>[],\n): void {\n  defineRecords(entity, records as RecordValue | RecordValue[])\n}\n\nexport function many<R extends Record<string, unknown>>(n: number, fn: (ctx: Ctx) => R): R {\n  return Array.from({ length: n }, () => fn) as unknown as R\n}\n\nlet active: RefIndex | undefined\n\nexport function setActiveRefIndex(refIndex: RefIndex | undefined): void {\n  active = refIndex\n}\n\nfunction requireActive(): RefIndex {\n  if (!active) {\n    throw new RefError('ref()/refs() may only be called while resolving definitions.')\n  }\n  return active\n}\n\nexport function ref(path: string): string {\n  const slash = path.indexOf('/')\n  if (slash === -1) {\n    throw new RefError(`ref('${path}') must be of the form 'entity/key'.`)\n  }\n  const entity = path.slice(0, slash)\n  const key = path.slice(slash + 1)\n  const id = requireActive().byEntity.get(entity)?.byKey.get(key)\n  if (!id) {\n    throw new RefError(`ref('${path}') does not match any defined record.`)\n  }\n  return id\n}\n\nexport function refs(entity: string): string[] {\n  const slot = requireActive().byEntity.get(entity)\n  if (!slot) {\n    throw new RefError(`refs('${entity}') does not match any defined entity.`)\n  }\n  return [...slot.all]\n}\n","import type { Ctx } from './ctx'\nimport { isPlainObject } from './is-plain-object'\n\nexport function resolveValue(value: unknown, ctx: Ctx): unknown {\n  if (typeof value === 'function') {\n    return resolveValue((value as (ctx: Ctx) => unknown)(ctx), ctx)\n  }\n  if (Array.isArray(value)) {\n    return value.map((item) => resolveValue(item, ctx))\n  }\n  if (isPlainObject(value)) {\n    const out: Record<string, unknown> = {}\n    for (const [key, v] of Object.entries(value)) {\n      if (key === '$key') continue\n      out[key] = resolveValue(v, ctx)\n    }\n    return out\n  }\n  return value\n}\n","export type { Ctx } from './ctx'\nexport { define, many, ref, refs, setActiveRefIndex } from './define'\nexport { RefError } from './errors'\nexport { deterministicId, recordHash } from './ids'\nexport { isPlainObject } from './is-plain-object'\nexport type { DrainedEntries, RawEntry, RecordValue, RefIndex } from './registry'\nexport { buildRefIndex, drain, resetRegistry } from './registry'\nexport { resolveValue } from './resolve'\nexport type { DefineRecord, EntityName } from './schema'\n","import { createJiti } from 'jiti'\nimport * as core from '../define'\n\nexport class LoadModuleError extends Error {}\n\nconst jiti = createJiti(import.meta.url, {\n  virtualModules: { '@fakeware/core': core },\n})\n\nexport async function loadModule<T = unknown>(absPath: string): Promise<T> {\n  try {\n    return (await jiti.import(absPath)) as T\n  } catch (error) {\n    throw new LoadModuleError(\n      `Could not load ${absPath}: ${error instanceof Error ? error.message : String(error)}`,\n    )\n  }\n}\n","import type { FakewareUserConfig } from './schema'\n\nexport interface ConfigEnv {\n  env: Record<string, string | undefined>\n  mode: string\n}\n\nexport type FakewareConfigFn = (env: ConfigEnv) => FakewareUserConfig\n\nexport function defineConfig(config: FakewareUserConfig): FakewareUserConfig\nexport function defineConfig(config: FakewareConfigFn): FakewareConfigFn\nexport function defineConfig(\n  config: FakewareUserConfig | FakewareConfigFn,\n): FakewareUserConfig | FakewareConfigFn {\n  return config\n}\n","export class ConfigError extends Error {}\n","import { ConfigError } from './errors'\n\nconst ENV_REF = /^\\$([A-Z0-9_]+)$/\n\nexport function interpolate<T>(value: T, env: Record<string, string | undefined>): T {\n  if (typeof value === 'string') {\n    const match = ENV_REF.exec(value)\n    if (!match) return value\n    const name = match[1] as string\n    const resolved = env[name]\n    if (resolved === undefined) {\n      throw new ConfigError(`Config references $${name}, but it is not set (check your .env).`)\n    }\n    return resolved as unknown as T\n  }\n  if (Array.isArray(value)) {\n    return value.map((item) => interpolate(item, env)) as unknown as T\n  }\n  if (value && typeof value === 'object') {\n    const out: Record<string, unknown> = {}\n    for (const [k, v] of Object.entries(value)) {\n      out[k] = interpolate(v, env)\n    }\n    return out as T\n  }\n  return value\n}\n","import { z } from 'zod'\n\nexport const shopwareSchema = z.object({\n  url: z.string().min(1, 'shopware.url is required'),\n  clientId: z.string().min(1, 'shopware.clientId is required'),\n  clientSecret: z.string().min(1, 'shopware.clientSecret is required'),\n})\n\nexport const transactionSchema = z.object({\n  onError: z.enum(['rollback', 'continue', 'stop']).default('rollback'),\n  atomic: z.boolean().default(true),\n})\n\nexport const fakewareConfigSchema = z.object({\n  shopware: shopwareSchema.optional(),\n  transaction: transactionSchema.prefault({}),\n})\n\nexport type TransactionConfig = z.output<typeof transactionSchema>\n\nexport type FakewareConfig = z.output<typeof fakewareConfigSchema>\n\nexport type FakewareUserConfig = z.input<typeof fakewareConfigSchema>\n","import { access, readFile } from 'node:fs/promises'\nimport { dirname, isAbsolute, join, resolve } from 'node:path'\nimport { loadModule } from '../runtime'\nimport type { ShopwareConnection } from '../shopware'\nimport type { ConfigEnv, FakewareConfigFn } from './define'\nimport { ConfigError } from './errors'\nimport { interpolate } from './interpolate'\nimport { type FakewareConfig, type FakewareUserConfig, fakewareConfigSchema } from './schema'\n\nexport const DEFAULT_CONFIG_FILENAME = 'fakeware.config.ts'\n\nexport interface LoadConfigOptions {\n  cwd?: string\n  configFile?: string\n  mode?: string\n}\n\nexport interface LoadedConfig {\n  config: FakewareConfig\n  connection: ShopwareConnection\n  configPath: string\n  projectRoot: string\n}\n\nasync function fileExists(path: string): Promise<boolean> {\n  try {\n    await access(path)\n    return true\n  } catch {\n    return false\n  }\n}\n\nasync function findConfig(cwd: string): Promise<string> {\n  let dir = cwd\n  for (;;) {\n    const candidate = join(dir, DEFAULT_CONFIG_FILENAME)\n    if (await fileExists(candidate)) return candidate\n    const parent = dirname(dir)\n    if (parent === dir) break\n    dir = parent\n  }\n  throw new ConfigError(\n    `No ${DEFAULT_CONFIG_FILENAME} found in ${cwd} or any parent directory. Run \\`fakeware init\\` first.`,\n  )\n}\n\nasync function readEnvFile(projectRoot: string): Promise<Record<string, string>> {\n  const path = join(projectRoot, '.env')\n  if (!(await fileExists(path))) return {}\n  const out: Record<string, string> = {}\n  const contents = await readFile(path, 'utf8')\n  for (const raw of contents.split('\\n')) {\n    const line = raw.trim()\n    if (!line || line.startsWith('#')) continue\n    const eq = line.indexOf('=')\n    if (eq === -1) continue\n    const key = line.slice(0, eq).trim()\n    let val = line.slice(eq + 1).trim()\n    if ((val.startsWith('\"') && val.endsWith('\"')) || (val.startsWith(\"'\") && val.endsWith(\"'\"))) {\n      val = val.slice(1, -1)\n    }\n    out[key] = val\n  }\n  return out\n}\n\nfunction isConfigFn(value: unknown): value is FakewareConfigFn {\n  return typeof value === 'function'\n}\n\nexport async function loadConfig(opts: LoadConfigOptions = {}): Promise<LoadedConfig> {\n  const cwd = opts.cwd ?? process.cwd()\n  const configPath = opts.configFile\n    ? isAbsolute(opts.configFile)\n      ? opts.configFile\n      : resolve(cwd, opts.configFile)\n    : await findConfig(cwd)\n  const projectRoot = dirname(configPath)\n\n  const env: Record<string, string | undefined> = {\n    ...process.env,\n    ...(await readEnvFile(projectRoot)),\n  }\n\n  const mod = await loadModule<{ default?: unknown }>(configPath)\n  const exported = mod.default\n  if (exported === undefined) {\n    throw new ConfigError(`${configPath} must \\`export default defineConfig(...)\\`.`)\n  }\n\n  const configEnv: ConfigEnv = { env, mode: opts.mode ?? 'development' }\n  const raw = isConfigFn(exported) ? exported(configEnv) : (exported as FakewareUserConfig)\n\n  const interpolated = interpolate(raw, env)\n\n  const parsed = fakewareConfigSchema.safeParse(interpolated)\n  if (!parsed.success) {\n    throw new ConfigError(`Invalid config in ${configPath}: ${parsed.error.message}`)\n  }\n\n  const { shopware } = parsed.data\n  if (!shopware) {\n    throw new ConfigError(\n      `No \\`shopware\\` connection configured in ${configPath}. up/down need a shop to talk to.`,\n    )\n  }\n\n  return { config: parsed.data, connection: shopware, configPath, projectRoot }\n}\n"],"mappings":"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"}

package/dist/{index-BZFBgKu8.d.mts → index-Brciwig_.d.mts}

@@ -28,16 +28,35 @@ declare function fetchShopInfo(connection: ShopwareConnection): Promise<ShopInfo
 type SinkRecord = Record<string, unknown> & {
   id: string;
 };
+type SyncOperation = {
+  entity: string;
+  action: 'upsert';
+  records: SinkRecord[];
+} | {
+  entity: string;
+  action: 'delete';
+  ids: string[];
+};
+interface BatchProgress {
+  records: number;
+  recordsTotal: number;
+  batches: number;
+  batchesTotal: number;
+}
+type OnBatch = (progress: BatchProgress) => void;
 interface ShopwareSink {
-  upsert(entity: string, records: SinkRecord[]): Promise<void>;
-  delete(entity: string, ids: string[]): Promise<void>;
+  upsert(entity: string, records: SinkRecord[], onBatch?: OnBatch): Promise<void>;
+  delete(entity: string, ids: string[], onBatch?: OnBatch): Promise<void>;
+  applyAtomic(operations: SyncOperation[]): Promise<void>;
 }
 //#endregion
 //#region src/shopware/sink.d.ts
 interface SyncSinkOptions {
   client?: ShopwareClient;
 }
+declare const ATOMIC_REQUEST_BYTE_LIMIT: number;
+declare function estimateSyncBytes(operations: SyncOperation[]): number;
 declare function createSyncSink(connection: ShopwareConnection, options?: SyncSinkOptions): ShopwareSink;
 //#endregion
-export { toConnectionError as a, ShopwareClient as c, ShopwareConnection as d, fetchShopInfo as i, createShopwareClient as l, ShopwareSink as n, validateConnection as o, SinkRecord as r, ShopwareConnectionError as s, createSyncSink as t, ShopInfo as u };
-//# sourceMappingURL=index-BZFBgKu8.d.mts.map
+export { ShopwareSink as a, fetchShopInfo as c, ShopwareConnectionError as d, ShopwareClient as f, ShopwareConnection as h, BatchProgress as i, toConnectionError as l, ShopInfo as m, createSyncSink as n, SinkRecord as o, createShopwareClient as p, estimateSyncBytes as r, SyncOperation as s, ATOMIC_REQUEST_BYTE_LIMIT as t, validateConnection as u };
+//# sourceMappingURL=index-Brciwig_.d.mts.map

package/dist/{index-Dpb1t7ns.d.mts → index-jYm7NShY.d.mts}

@@ -1,4 +1,4 @@
-import { d as ShopwareConnection } from "./index-BZFBgKu8.mjs";
+import { h as ShopwareConnection } from "./index-Brciwig_.mjs";
 import { z } from "zod";
 
 //#region src/config/schema.d.ts
@@ -7,13 +7,30 @@ declare const shopwareSchema: z.ZodObject<{
   clientId: z.ZodString;
   clientSecret: z.ZodString;
 }, z.core.$strip>;
+declare const transactionSchema: z.ZodObject<{
+  onError: z.ZodDefault<z.ZodEnum<{
+    rollback: "rollback";
+    continue: "continue";
+    stop: "stop";
+  }>>;
+  atomic: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
 declare const fakewareConfigSchema: z.ZodObject<{
   shopware: z.ZodOptional<z.ZodObject<{
     url: z.ZodString;
     clientId: z.ZodString;
     clientSecret: z.ZodString;
   }, z.core.$strip>>;
+  transaction: z.ZodPrefault<z.ZodObject<{
+    onError: z.ZodDefault<z.ZodEnum<{
+      rollback: "rollback";
+      continue: "continue";
+      stop: "stop";
+    }>>;
+    atomic: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$strip>>;
 }, z.core.$strip>;
+type TransactionConfig = z.output<typeof transactionSchema>;
 type FakewareConfig = z.output<typeof fakewareConfigSchema>;
 type FakewareUserConfig = z.input<typeof fakewareConfigSchema>;
 //#endregion
@@ -47,5 +64,5 @@ interface LoadedConfig {
 }
 declare function loadConfig(opts?: LoadConfigOptions): Promise<LoadedConfig>;
 //#endregion
-export { interpolate as a, FakewareConfigFn as c, FakewareUserConfig as d, fakewareConfigSchema as f, loadConfig as i, defineConfig as l, LoadConfigOptions as n, ConfigError as o, shopwareSchema as p, LoadedConfig as r, ConfigEnv as s, DEFAULT_CONFIG_FILENAME as t, FakewareConfig as u };
-//# sourceMappingURL=index-Dpb1t7ns.d.mts.map
+export { interpolate as a, FakewareConfigFn as c, FakewareUserConfig as d, TransactionConfig as f, transactionSchema as h, loadConfig as i, defineConfig as l, shopwareSchema as m, LoadConfigOptions as n, ConfigError as o, fakewareConfigSchema as p, LoadedConfig as r, ConfigEnv as s, DEFAULT_CONFIG_FILENAME as t, FakewareConfig as u };
+//# sourceMappingURL=index-jYm7NShY.d.mts.map

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { r as LoadedConfig } from "./index-Dpb1t7ns.mjs";
-import { n as ShopwareSink, r as SinkRecord } from "./index-BZFBgKu8.mjs";
+import { r as LoadedConfig } from "./index-jYm7NShY.mjs";
+import { a as ShopwareSink, i as BatchProgress, o as SinkRecord, s as SyncOperation } from "./index-Brciwig_.mjs";
 import { Schemas } from "@shopware/api-client/admin-api-types";
 
 //#region src/define/ctx.d.ts
@@ -44,32 +44,28 @@ declare function refs(entity: string): string[];
 //#region src/define/errors.d.ts
 declare class RefError extends Error {}
 //#endregion
-//#region src/engine/errors.d.ts
-declare class GraphError extends Error {}
-//#endregion
-//#region src/engine/manifest.d.ts
-interface ManifestRecord {
-  id: string;
-  hash: string;
-}
-interface ManifestEntity {
-  entity: string;
-  records: ManifestRecord[];
-}
-interface Manifest {
-  version: 1;
-  fakewareVersion: string;
-  createdAt: string;
-  shopwareUrl: string;
-  entities: ManifestEntity[];
-  checksum: string;
-}
-declare function readManifest(projectRoot: string, shopwareUrl: string): Promise<Manifest | null>;
-//#endregion
 //#region src/engine/run.d.ts
 interface Reporter {
-  onStart?(entity: string): void;
+  onStart?(entity: string, records?: number): void;
+  onBatch?(progress: BatchProgress): void;
   onStep?(step: ReportStep): void;
+  onTransactionStart?(info: {
+    mode: 'atomic' | 'saga';
+  }): void;
+  onCommit?(info: {
+    committed: number;
+  }): void;
+  onCompensate?(entity: string, count: number): void;
+  onCompensateFail?(entity: string): void;
+  onSkip?(info: {
+    entity: string;
+    error: unknown;
+  }): void;
+  onStop?(info: {
+    failedEntity: string;
+    error: unknown;
+    message: string;
+  }): void;
 }
 interface ReportStep {
   entity: string;
@@ -78,6 +74,11 @@ interface ReportStep {
   unchanged: number;
   deleted: number;
 }
+type OnError = 'rollback' | 'continue' | 'stop';
+interface TransactionOptions {
+  onError: OnError;
+  atomic: boolean;
+}
 interface RunOptions {
   loaded: LoadedConfig;
   sink: ShopwareSink;
@@ -85,10 +86,14 @@ interface RunOptions {
   reporter?: Reporter;
   fakewareVersion?: string;
   now?: string;
+  transaction?: TransactionOptions;
 }
 interface UpResult {
   steps: ReportStep[];
   manifestWritten: boolean;
+  mode: 'atomic' | 'saga' | 'dry-run' | 'noop';
+  committed: number;
+  rolledBack: number;
 }
 interface DownResult {
   steps: ReportStep[];
@@ -97,8 +102,43 @@ interface DownResult {
 declare function runUp(opts: RunOptions): Promise<UpResult>;
 declare function runDown(opts: RunOptions): Promise<DownResult>;
 //#endregion
+//#region src/engine/errors.d.ts
+declare class GraphError extends Error {}
+declare class TransactionError extends Error {
+  readonly rolledBack: ReportStep[];
+  readonly failedEntity: string;
+  readonly unrevertableUpdates: boolean;
+  readonly compensationErrors: unknown[];
+  constructor(message: string, options: {
+    cause: unknown;
+    rolledBack: ReportStep[];
+    failedEntity: string;
+    unrevertableUpdates?: boolean;
+    compensationErrors?: unknown[];
+  });
+}
+//#endregion
+//#region src/engine/manifest.d.ts
+interface ManifestRecord {
+  id: string;
+  hash: string;
+}
+interface ManifestEntity {
+  entity: string;
+  records: ManifestRecord[];
+}
+interface Manifest {
+  version: 1;
+  fakewareVersion: string;
+  createdAt: string;
+  shopwareUrl: string;
+  entities: ManifestEntity[];
+  checksum: string;
+}
+declare function readManifest(projectRoot: string, shopwareUrl: string): Promise<Manifest | null>;
+//#endregion
 //#region src/runtime/load-module.d.ts
 declare class LoadModuleError extends Error {}
 //#endregion
-export { type Ctx, type DefineRecord, type DownResult, type EntityName, GraphError, LoadModuleError, type Manifest, type ManifestEntity, type ManifestRecord, RefError, type ReportStep, type Reporter, type RunOptions, type ShopwareSink, type SinkRecord, type UpResult, define, many, readManifest, ref, refs, runDown, runUp };
+export { type BatchProgress, type Ctx, type DefineRecord, type DownResult, type EntityName, GraphError, LoadModuleError, type Manifest, type ManifestEntity, type ManifestRecord, type OnError, RefError, type ReportStep, type Reporter, type RunOptions, type ShopwareSink, type SinkRecord, type SyncOperation, TransactionError, type TransactionOptions, type UpResult, define, many, readManifest, ref, refs, runDown, runUp };
 //# sourceMappingURL=index.d.mts.map