syncorejs 0.1.0

package/dist/schema/src/validators.js

@@ -0,0 +1,158 @@
+//#region ../schema/src/validators.ts
+var StringValidator = class {
+	kind = "string";
+	parse(value, path = "value") {
+		if (typeof value !== "string") throw new Error(`${path} must be a string.`);
+		return value;
+	}
+};
+var NumberValidator = class {
+	kind = "number";
+	parse(value, path = "value") {
+		if (typeof value !== "number" || Number.isNaN(value)) throw new Error(`${path} must be a number.`);
+		return value;
+	}
+};
+var BooleanValidator = class {
+	kind = "boolean";
+	parse(value, path = "value") {
+		if (typeof value !== "boolean") throw new Error(`${path} must be a boolean.`);
+		return value;
+	}
+};
+var NullValidator = class {
+	kind = "null";
+	parse(value, path = "value") {
+		if (value !== null) throw new Error(`${path} must be null.`);
+		return null;
+	}
+};
+var AnyValidator = class {
+	kind = "any";
+	parse(value) {
+		return value;
+	}
+};
+var LiteralValidator = class {
+	kind = "literal";
+	constructor(literalValue) {
+		this.literalValue = literalValue;
+	}
+	parse(value, path = "value") {
+		if (value !== this.literalValue) throw new Error(`${path} must equal ${String(this.literalValue)}.`);
+		return this.literalValue;
+	}
+};
+var ArrayValidator = class {
+	kind = "array";
+	constructor(itemValidator) {
+		this.itemValidator = itemValidator;
+	}
+	parse(value, path = "value") {
+		if (!Array.isArray(value)) throw new Error(`${path} must be an array.`);
+		return value.map((item, index) => this.itemValidator.parse(item, `${path}[${index}]`));
+	}
+};
+var ObjectValidator = class {
+	kind = "object";
+	constructor(shape) {
+		this.shape = shape;
+	}
+	parse(value, path = "value") {
+		if (typeof value !== "object" || value === null || Array.isArray(value)) throw new Error(`${path} must be an object.`);
+		const source = value;
+		const parsed = {};
+		for (const [key, validator] of Object.entries(this.shape)) {
+			if (validator.kind === "optional" && source[key] === void 0) continue;
+			parsed[key] = validator.parse(source[key], `${path}.${key}`);
+		}
+		return parsed;
+	}
+};
+var IdValidator = class {
+	kind = "id";
+	constructor(tableName) {
+		this.tableName = tableName;
+	}
+	parse(value, path = "value") {
+		if (typeof value !== "string" || value.length === 0) throw new Error(`${path} must be a non-empty id string.`);
+		return value;
+	}
+};
+var OptionalValidator = class {
+	kind = "optional";
+	constructor(inner) {
+		this.inner = inner;
+	}
+	parse(value, path = "value") {
+		if (value === void 0) return;
+		return this.inner.parse(value, path);
+	}
+};
+function isValidator(value) {
+	return typeof value.parse === "function";
+}
+function ensureObjectValidator(value) {
+	if (isValidator(value)) return value;
+	return new ObjectValidator(value);
+}
+/**
+* Build runtime validators for schemas, function args, and return values.
+*
+* @example
+* ```ts
+* defineTable({
+*   text: v.string(),
+*   done: v.boolean(),
+*   ownerId: v.optional(v.id("users"))
+* });
+* ```
+*/
+const v = {
+	string: () => new StringValidator(),
+	number: () => new NumberValidator(),
+	boolean: () => new BooleanValidator(),
+	null: () => new NullValidator(),
+	any: () => new AnyValidator(),
+	literal: (literalValue) => new LiteralValidator(literalValue),
+	array: (itemValidator) => new ArrayValidator(itemValidator),
+	object: (shape) => new ObjectValidator(shape),
+	id: (tableName) => new IdValidator(tableName),
+	optional: (inner) => new OptionalValidator(inner)
+};
+function describeValidator(validator) {
+	switch (validator.kind) {
+		case "string":
+		case "number":
+		case "boolean":
+		case "null":
+		case "any": return { kind: validator.kind };
+		case "literal": return {
+			kind: "literal",
+			value: validator.literalValue
+		};
+		case "array": return {
+			kind: "array",
+			item: describeValidator(validator.itemValidator)
+		};
+		case "object": {
+			const objectValidator = validator;
+			return {
+				kind: "object",
+				shape: Object.fromEntries(Object.entries(objectValidator.shape).map(([key, nested]) => [key, describeValidator(nested)]))
+			};
+		}
+		case "id": return {
+			kind: "id",
+			tableName: validator.tableName
+		};
+		case "optional": return {
+			kind: "optional",
+			inner: describeValidator(validator.inner)
+		};
+	}
+}
+//#endregion
+export { AnyValidator, ArrayValidator, BooleanValidator, IdValidator, LiteralValidator, NullValidator, NumberValidator, ObjectValidator, OptionalValidator, StringValidator, describeValidator, ensureObjectValidator, v };
+
+//# sourceMappingURL=validators.js.map

package/dist/schema/src/validators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.js","names":[],"sources":["../../../../schema/src/validators.ts"],"sourcesContent":["export type ValidatorKind =\r\n  | \"string\"\r\n  | \"number\"\r\n  | \"boolean\"\r\n  | \"literal\"\r\n  | \"array\"\r\n  | \"object\"\r\n  | \"id\"\r\n  | \"optional\"\r\n  | \"any\"\r\n  | \"null\";\r\n\r\n/**\r\n * Validates unknown input at runtime and carries its parsed TypeScript type.\r\n *\r\n * Syncore uses validators for function arguments, return values, and table\r\n * definitions. Most apps create validators through {@link v} instead of\r\n * instantiating validator classes directly.\r\n */\r\nexport interface Validator<TValue> {\r\n  readonly kind: ValidatorKind;\r\n\r\n  /**\r\n   * Parse and validate an unknown value.\r\n   *\r\n   * @param value - The value to validate.\r\n   * @param path - A human-readable path used in validation errors.\r\n   * @returns The parsed value when validation succeeds.\r\n   */\r\n  parse(value: unknown, path?: string): TValue;\r\n}\r\n\r\nexport type ValidatorDescription =\r\n  | { kind: \"string\" }\r\n  | { kind: \"number\" }\r\n  | { kind: \"boolean\" }\r\n  | { kind: \"null\" }\r\n  | { kind: \"any\" }\r\n  | { kind: \"literal\"; value: string | number | boolean | null }\r\n  | { kind: \"array\"; item: ValidatorDescription }\r\n  | { kind: \"object\"; shape: Record<string, ValidatorDescription> }\r\n  | { kind: \"id\"; tableName: string }\r\n  | { kind: \"optional\"; inner: ValidatorDescription };\r\n\r\nexport interface ObjectValidatorShape {\r\n  [key: string]: Validator<unknown>;\r\n}\r\n\r\nexport class StringValidator implements Validator<string> {\r\n  readonly kind = \"string\" as const;\r\n\r\n  parse(value: unknown, path = \"value\"): string {\r\n    if (typeof value !== \"string\") {\r\n      throw new Error(`${path} must be a string.`);\r\n    }\r\n    return value;\r\n  }\r\n}\r\n\r\nexport class NumberValidator implements Validator<number> {\r\n  readonly kind = \"number\" as const;\r\n\r\n  parse(value: unknown, path = \"value\"): number {\r\n    if (typeof value !== \"number\" || Number.isNaN(value)) {\r\n      throw new Error(`${path} must be a number.`);\r\n    }\r\n    return value;\r\n  }\r\n}\r\n\r\nexport class BooleanValidator implements Validator<boolean> {\r\n  readonly kind = \"boolean\" as const;\r\n\r\n  parse(value: unknown, path = \"value\"): boolean {\r\n    if (typeof value !== \"boolean\") {\r\n      throw new Error(`${path} must be a boolean.`);\r\n    }\r\n    return value;\r\n  }\r\n}\r\n\r\nexport class NullValidator implements Validator<null> {\r\n  readonly kind = \"null\" as const;\r\n\r\n  parse(value: unknown, path = \"value\"): null {\r\n    if (value !== null) {\r\n      throw new Error(`${path} must be null.`);\r\n    }\r\n    return null;\r\n  }\r\n}\r\n\r\nexport class AnyValidator implements Validator<unknown> {\r\n  readonly kind = \"any\" as const;\r\n\r\n  parse(value: unknown): unknown {\r\n    return value;\r\n  }\r\n}\r\n\r\nexport class LiteralValidator<\r\n  TValue extends string | number | boolean | null\r\n> implements Validator<TValue> {\r\n  readonly kind = \"literal\" as const;\r\n\r\n  constructor(public readonly literalValue: TValue) {}\r\n\r\n  parse(value: unknown, path = \"value\"): TValue {\r\n    if (value !== this.literalValue) {\r\n      throw new Error(`${path} must equal ${String(this.literalValue)}.`);\r\n    }\r\n    return this.literalValue;\r\n  }\r\n}\r\n\r\nexport class ArrayValidator<TItem> implements Validator<TItem[]> {\r\n  readonly kind = \"array\" as const;\r\n\r\n  constructor(public readonly itemValidator: Validator<TItem>) {}\r\n\r\n  parse(value: unknown, path = \"value\"): TItem[] {\r\n    if (!Array.isArray(value)) {\r\n      throw new Error(`${path} must be an array.`);\r\n    }\r\n    return value.map((item, index) =>\r\n      this.itemValidator.parse(item, `${path}[${index}]`)\r\n    );\r\n  }\r\n}\r\n\r\nexport class ObjectValidator<\r\n  TShape extends ObjectValidatorShape\r\n> implements Validator<{ [TKey in keyof TShape]: Infer<TShape[TKey]> }> {\r\n  readonly kind = \"object\" as const;\r\n\r\n  constructor(public readonly shape: TShape) {}\r\n\r\n  parse(\r\n    value: unknown,\r\n    path = \"value\"\r\n  ): { [TKey in keyof TShape]: Infer<TShape[TKey]> } {\r\n    if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\r\n      throw new Error(`${path} must be an object.`);\r\n    }\r\n\r\n    const source = value as Record<string, unknown>;\r\n    const parsed: Record<string, unknown> = {};\r\n\r\n    for (const [key, validator] of Object.entries(this.shape)) {\r\n      const optional =\r\n        validator.kind === \"optional\" && source[key] === undefined;\r\n      if (optional) {\r\n        continue;\r\n      }\r\n      parsed[key] = validator.parse(source[key], `${path}.${key}`);\r\n    }\r\n\r\n    return parsed as { [TKey in keyof TShape]: Infer<TShape[TKey]> };\r\n  }\r\n}\r\n\r\nexport class IdValidator<\r\n  TTableName extends string\r\n> implements Validator<string> {\r\n  readonly kind = \"id\" as const;\r\n\r\n  constructor(public readonly tableName: TTableName) {}\r\n\r\n  parse(value: unknown, path = \"value\"): string {\r\n    if (typeof value !== \"string\" || value.length === 0) {\r\n      throw new Error(`${path} must be a non-empty id string.`);\r\n    }\r\n    return value;\r\n  }\r\n}\r\n\r\nexport class OptionalValidator<TValue> implements Validator<\r\n  TValue | undefined\r\n> {\r\n  readonly kind = \"optional\" as const;\r\n\r\n  constructor(public readonly inner: Validator<TValue>) {}\r\n\r\n  parse(value: unknown, path = \"value\"): TValue | undefined {\r\n    if (value === undefined) {\r\n      return undefined;\r\n    }\r\n    return this.inner.parse(value, path);\r\n  }\r\n}\r\n\r\nexport type Infer<TValidator> =\r\n  TValidator extends Validator<infer TValue> ? TValue : never;\r\n\r\nexport type ValidatorMap = Record<string, Validator<unknown>>;\r\n\r\n/**\r\n * The public validator builder API.\r\n *\r\n * Hover each property in your editor to see what it validates and how to use it.\r\n */\r\nexport interface ValidatorBuilderApi {\r\n  /**\r\n   * Validate a string value.\r\n   *\r\n   * @returns A validator that accepts JavaScript strings.\r\n   */\r\n  string(): StringValidator;\r\n\r\n  /**\r\n   * Validate a number value.\r\n   *\r\n   * @returns A validator that accepts finite JavaScript numbers.\r\n   */\r\n  number(): NumberValidator;\r\n\r\n  /**\r\n   * Validate a boolean value.\r\n   *\r\n   * @returns A validator that accepts `true` and `false`.\r\n   */\r\n  boolean(): BooleanValidator;\r\n\r\n  /**\r\n   * Validate the literal value `null`.\r\n   *\r\n   * @returns A validator that only accepts `null`.\r\n   */\r\n  null(): NullValidator;\r\n\r\n  /**\r\n   * Accept any value without validation.\r\n   *\r\n   * Use this sparingly for escape hatches when you do not want Syncore to\r\n   * enforce a more specific runtime shape.\r\n   */\r\n  any(): AnyValidator;\r\n\r\n  /**\r\n   * Validate a single literal value.\r\n   *\r\n   * @param literalValue - The exact value that must be provided.\r\n   * @returns A validator that only accepts that one value.\r\n   */\r\n  literal<TValue extends string | number | boolean | null>(\r\n    literalValue: TValue\r\n  ): LiteralValidator<TValue>;\r\n\r\n  /**\r\n   * Validate an array whose items all use the same validator.\r\n   *\r\n   * @param itemValidator - The validator for each item in the array.\r\n   * @returns A validator for arrays of the provided item type.\r\n   */\r\n  array<TItem>(itemValidator: Validator<TItem>): ArrayValidator<TItem>;\r\n\r\n  /**\r\n   * Validate an object with a fixed property shape.\r\n   *\r\n   * @param shape - The validators for each property on the object.\r\n   * @returns A validator for objects matching that shape.\r\n   */\r\n  object<TShape extends ObjectValidatorShape>(\r\n    shape: TShape\r\n  ): ObjectValidator<TShape>;\r\n\r\n  /**\r\n   * Validate an identifier string that points at a table.\r\n   *\r\n   * Use this for document ids that come from Syncore tables.\r\n   *\r\n   * @param tableName - The name of the referenced table.\r\n   * @returns A validator for ids belonging to that table.\r\n   */\r\n  id<TTableName extends string>(tableName: TTableName): IdValidator<TTableName>;\r\n\r\n  /**\r\n   * Make another validator optional.\r\n   *\r\n   * @param inner - The validator for the defined case.\r\n   * @returns A validator that accepts `undefined` or the inner value.\r\n   */\r\n  optional<TValue>(inner: Validator<TValue>): OptionalValidator<TValue>;\r\n}\r\n\r\nfunction isValidator(\r\n  value: Validator<unknown> | ValidatorMap\r\n): value is Validator<unknown> {\r\n  return typeof (value as Validator<unknown>).parse === \"function\";\r\n}\r\n\r\nexport function ensureObjectValidator(\r\n  value: Validator<unknown> | ValidatorMap\r\n): Validator<unknown> {\r\n  if (isValidator(value)) {\r\n    return value;\r\n  }\r\n  return new ObjectValidator(value);\r\n}\r\n\r\n/**\r\n * Build runtime validators for schemas, function args, and return values.\r\n *\r\n * @example\r\n * ```ts\r\n * defineTable({\r\n *   text: v.string(),\r\n *   done: v.boolean(),\r\n *   ownerId: v.optional(v.id(\"users\"))\r\n * });\r\n * ```\r\n */\r\nexport const v: ValidatorBuilderApi = {\r\n  string: () => new StringValidator(),\r\n  number: () => new NumberValidator(),\r\n  boolean: () => new BooleanValidator(),\r\n  null: () => new NullValidator(),\r\n  any: () => new AnyValidator(),\r\n  literal: <TValue extends string | number | boolean | null>(\r\n    literalValue: TValue\r\n  ) => new LiteralValidator(literalValue),\r\n  array: <TItem>(itemValidator: Validator<TItem>) =>\r\n    new ArrayValidator(itemValidator),\r\n  object: <TShape extends ObjectValidatorShape>(shape: TShape) =>\r\n    new ObjectValidator(shape),\r\n  id: <TTableName extends string>(tableName: TTableName) =>\r\n    new IdValidator(tableName),\r\n  optional: <TValue>(inner: Validator<TValue>) => new OptionalValidator(inner)\r\n};\r\n\r\nexport function describeValidator(\r\n  validator: Validator<unknown>\r\n): ValidatorDescription {\r\n  switch (validator.kind) {\r\n    case \"string\":\r\n    case \"number\":\r\n    case \"boolean\":\r\n    case \"null\":\r\n    case \"any\":\r\n      return { kind: validator.kind };\r\n    case \"literal\":\r\n      return {\r\n        kind: \"literal\",\r\n        value: (validator as LiteralValidator<string | number | boolean | null>)\r\n          .literalValue\r\n      };\r\n    case \"array\":\r\n      return {\r\n        kind: \"array\",\r\n        item: describeValidator(\r\n          (validator as ArrayValidator<unknown>).itemValidator\r\n        )\r\n      };\r\n    case \"object\": {\r\n      const objectValidator =\r\n        validator as ObjectValidator<ObjectValidatorShape>;\r\n      return {\r\n        kind: \"object\",\r\n        shape: Object.fromEntries(\r\n          Object.entries(objectValidator.shape).map(([key, nested]) => [\r\n            key,\r\n            describeValidator(nested)\r\n          ])\r\n        )\r\n      };\r\n    }\r\n    case \"id\":\r\n      return {\r\n        kind: \"id\",\r\n        tableName: (validator as IdValidator<string>).tableName\r\n      };\r\n    case \"optional\":\r\n      return {\r\n        kind: \"optional\",\r\n        inner: describeValidator(\r\n          (validator as OptionalValidator<unknown>).inner\r\n        )\r\n      };\r\n  }\r\n}\r\n"],"mappings":"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"}

package/dist/svelte/src/index.d.ts

@@ -0,0 +1,44 @@
+import { FunctionArgs, FunctionReference, FunctionResult } from "../../core/src/runtime/functions.js";
+import { SyncoreClient } from "../../core/src/runtime/runtime.js";
+import { Readable } from "svelte/store";
+
+//#region ../svelte/src/index.d.ts
+type OptionalArgsTuple<TArgs> = Record<never, never> extends TArgs ? [args?: TArgs] : [args: TArgs];
+/**
+ * The observable state exposed by a Syncore-backed Svelte query store.
+ */
+interface SyncoreQueryStoreState<TResult> {
+  /** The latest local result for the watched query. */
+  data: TResult | undefined;
+  /** The latest local error for the watched query, if any. */
+  error: Error | undefined;
+  /** The current watch lifecycle status. */
+  status: "loading" | "ready" | "error";
+}
+/**
+ * Store a Syncore client in the current Svelte component context.
+ */
+declare function setSyncoreClient(client: SyncoreClient): SyncoreClient;
+/**
+ * Read the active Syncore client from the current Svelte component context.
+ */
+declare function getSyncoreClient(): SyncoreClient;
+/**
+ * Create a readable Svelte store backed by a reactive Syncore query.
+ */
+declare function createQueryStore<TReference extends FunctionReference<"query">>(reference: TReference, ...args: OptionalArgsTuple<FunctionArgs<TReference>>): Readable<SyncoreQueryStoreState<FunctionResult<TReference>>>;
+/**
+ * Create a readable Svelte store backed by a reactive Syncore query.
+ */
+declare function createClientQueryStore<TReference extends FunctionReference<"query">>(client: SyncoreClient, reference: TReference, ...args: OptionalArgsTuple<FunctionArgs<TReference>>): Readable<SyncoreQueryStoreState<FunctionResult<TReference>>>;
+/**
+ * Create a function that executes a Syncore mutation.
+ */
+declare function createMutation<TReference extends FunctionReference<"mutation">>(reference: TReference): (...args: OptionalArgsTuple<FunctionArgs<TReference>>) => Promise<FunctionResult<TReference>>;
+/**
+ * Create a function that executes a Syncore action.
+ */
+declare function createAction<TReference extends FunctionReference<"action">>(reference: TReference): (...args: OptionalArgsTuple<FunctionArgs<TReference>>) => Promise<FunctionResult<TReference>>;
+//#endregion
+export { OptionalArgsTuple, SyncoreQueryStoreState, createAction, createClientQueryStore, createMutation, createQueryStore, getSyncoreClient, setSyncoreClient };
+//# sourceMappingURL=index.d.ts.map

package/dist/svelte/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../../svelte/src/index.ts"],"mappings":";;;;;KAUY,iBAAA,UACV,MAAA,uBAA6B,KAAA,IAAS,IAAA,GAAO,KAAA,KAAU,IAAA,EAAM,KAAA;;;AAD/D;UAMiB,sBAAA;EANY;EAQ3B,IAAA,EAAM,OAAA;EAPuB;EAU7B,KAAA,EAAO,KAAA;EAVsD;EAa7D,MAAA;AAAA;;;;iBAQc,gBAAA,CAAiB,MAAA,EAAQ,aAAA,GAAgB,aAAA;;;;iBAQzC,gBAAA,CAAA,GAAoB,aAAA;;AAxBpC;;iBAqCgB,gBAAA,oBAAoC,iBAAA,UAAA,CAClD,SAAA,EAAW,UAAA,KACR,IAAA,EAAM,iBAAA,CAAkB,YAAA,CAAa,UAAA,KACvC,QAAA,CAAS,sBAAA,CAAuB,cAAA,CAAe,UAAA;;;;iBAOlC,sBAAA,oBACK,iBAAA,UAAA,CAEnB,MAAA,EAAQ,aAAA,EACR,SAAA,EAAW,UAAA,KACR,IAAA,EAAM,iBAAA,CAAkB,YAAA,CAAa,UAAA,KACvC,QAAA,CAAS,sBAAA,CAAuB,cAAA,CAAe,UAAA;;;;iBAelC,cAAA,oBACK,iBAAA,aAAA,CAEnB,SAAA,EAAW,UAAA,OAER,IAAA,EAAM,iBAAA,CAAkB,YAAA,CAAa,UAAA,OACrC,OAAA,CAAQ,cAAA,CAAe,UAAA;;AA1D5B;;iBAqEgB,YAAA,oBAAgC,iBAAA,WAAA,CAC9C,SAAA,EAAW,UAAA,OAER,IAAA,EAAM,iBAAA,CAAkB,YAAA,CAAa,UAAA,OACrC,OAAA,CAAQ,cAAA,CAAe,UAAA"}

package/dist/svelte/src/index.js

@@ -0,0 +1,75 @@
+import { readable } from "svelte/store";
+import { getContext, setContext } from "svelte";
+//#region ../svelte/src/index.ts
+const SYNCORE_CLIENT_CONTEXT = Symbol("syncore.client");
+/**
+* Store a Syncore client in the current Svelte component context.
+*/
+function setSyncoreClient(client) {
+	setContext(SYNCORE_CLIENT_CONTEXT, client);
+	return client;
+}
+/**
+* Read the active Syncore client from the current Svelte component context.
+*/
+function getSyncoreClient() {
+	const client = getContext(SYNCORE_CLIENT_CONTEXT);
+	if (!client) throw new Error("Syncore client is missing from the Svelte component context.");
+	return client;
+}
+/**
+* Create a readable Svelte store backed by a reactive Syncore query.
+*/
+function createQueryStore(reference, ...args) {
+	return createClientQueryStore(getSyncoreClient(), reference, ...args);
+}
+/**
+* Create a readable Svelte store backed by a reactive Syncore query.
+*/
+function createClientQueryStore(client, reference, ...args) {
+	return readable({
+		data: void 0,
+		error: void 0,
+		status: "loading"
+	}, createQueryStoreStart(client, reference, normalizeOptionalArgs(args)));
+}
+/**
+* Create a function that executes a Syncore mutation.
+*/
+function createMutation(reference) {
+	const client = getSyncoreClient();
+	return (...args) => client.mutation(reference, normalizeOptionalArgs(args));
+}
+/**
+* Create a function that executes a Syncore action.
+*/
+function createAction(reference) {
+	const client = getSyncoreClient();
+	return (...args) => client.action(reference, normalizeOptionalArgs(args));
+}
+function createQueryStoreStart(client, reference, args) {
+	return (set) => {
+		const watch = client.watchQuery(reference, args);
+		const sync = () => {
+			const error = watch.localQueryError();
+			set({
+				data: watch.localQueryResult(),
+				error,
+				status: error ? "error" : "ready"
+			});
+		};
+		sync();
+		const unsubscribe = watch.onUpdate(sync);
+		return () => {
+			unsubscribe();
+			watch.dispose?.();
+		};
+	};
+}
+function normalizeOptionalArgs(args) {
+	return args[0] ?? {};
+}
+//#endregion
+export { createAction, createClientQueryStore, createMutation, createQueryStore, getSyncoreClient, setSyncoreClient };
+
+//# sourceMappingURL=index.js.map

package/dist/svelte/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../../svelte/src/index.ts"],"sourcesContent":["import { type Readable, type StartStopNotifier, readable } from \"svelte/store\";\nimport { getContext, setContext } from \"svelte\";\nimport type {\n  FunctionArgs,\n  FunctionReference,\n  FunctionResult,\n  SyncoreClient,\n  SyncoreWatch\n} from \"@syncore/core\";\n\nexport type OptionalArgsTuple<TArgs> =\n  Record<never, never> extends TArgs ? [args?: TArgs] : [args: TArgs];\n\n/**\n * The observable state exposed by a Syncore-backed Svelte query store.\n */\nexport interface SyncoreQueryStoreState<TResult> {\n  /** The latest local result for the watched query. */\n  data: TResult | undefined;\n\n  /** The latest local error for the watched query, if any. */\n  error: Error | undefined;\n\n  /** The current watch lifecycle status. */\n  status: \"loading\" | \"ready\" | \"error\";\n}\n\nconst SYNCORE_CLIENT_CONTEXT = Symbol(\"syncore.client\");\n\n/**\n * Store a Syncore client in the current Svelte component context.\n */\nexport function setSyncoreClient(client: SyncoreClient): SyncoreClient {\n  setContext(SYNCORE_CLIENT_CONTEXT, client);\n  return client;\n}\n\n/**\n * Read the active Syncore client from the current Svelte component context.\n */\nexport function getSyncoreClient(): SyncoreClient {\n  const client = getContext<SyncoreClient | undefined>(SYNCORE_CLIENT_CONTEXT);\n  if (!client) {\n    throw new Error(\n      \"Syncore client is missing from the Svelte component context.\"\n    );\n  }\n  return client;\n}\n\n/**\n * Create a readable Svelte store backed by a reactive Syncore query.\n */\nexport function createQueryStore<TReference extends FunctionReference<\"query\">>(\n  reference: TReference,\n  ...args: OptionalArgsTuple<FunctionArgs<TReference>>\n): Readable<SyncoreQueryStoreState<FunctionResult<TReference>>> {\n  return createClientQueryStore(getSyncoreClient(), reference, ...args);\n}\n\n/**\n * Create a readable Svelte store backed by a reactive Syncore query.\n */\nexport function createClientQueryStore<\n  TReference extends FunctionReference<\"query\">\n>(\n  client: SyncoreClient,\n  reference: TReference,\n  ...args: OptionalArgsTuple<FunctionArgs<TReference>>\n): Readable<SyncoreQueryStoreState<FunctionResult<TReference>>> {\n  const normalizedArgs = normalizeOptionalArgs(args);\n  return readable<SyncoreQueryStoreState<FunctionResult<TReference>>>(\n    {\n      data: undefined,\n      error: undefined,\n      status: \"loading\"\n    },\n    createQueryStoreStart(client, reference, normalizedArgs)\n  );\n}\n\n/**\n * Create a function that executes a Syncore mutation.\n */\nexport function createMutation<\n  TReference extends FunctionReference<\"mutation\">\n>(\n  reference: TReference\n): (\n  ...args: OptionalArgsTuple<FunctionArgs<TReference>>\n) => Promise<FunctionResult<TReference>> {\n  const client = getSyncoreClient();\n  return (...args) =>\n    client.mutation(reference, normalizeOptionalArgs(args)) as Promise<\n      FunctionResult<TReference>\n    >;\n}\n\n/**\n * Create a function that executes a Syncore action.\n */\nexport function createAction<TReference extends FunctionReference<\"action\">>(\n  reference: TReference\n): (\n  ...args: OptionalArgsTuple<FunctionArgs<TReference>>\n) => Promise<FunctionResult<TReference>> {\n  const client = getSyncoreClient();\n  return (...args) =>\n    client.action(reference, normalizeOptionalArgs(args)) as Promise<\n      FunctionResult<TReference>\n    >;\n}\n\nfunction createQueryStoreStart<TReference extends FunctionReference<\"query\">>(\n  client: SyncoreClient,\n  reference: TReference,\n  args: FunctionArgs<TReference>\n): StartStopNotifier<SyncoreQueryStoreState<FunctionResult<TReference>>> {\n  return (\n    set: (value: SyncoreQueryStoreState<FunctionResult<TReference>>) => void\n  ) => {\n    const watch = client.watchQuery(reference, args) as SyncoreWatch<\n      FunctionResult<TReference>\n    >;\n    const sync = () => {\n      const error = watch.localQueryError();\n      set({\n        data: watch.localQueryResult(),\n        error,\n        status: error ? \"error\" : \"ready\"\n      });\n    };\n    sync();\n    const unsubscribe = watch.onUpdate(sync);\n    return () => {\n      unsubscribe();\n      watch.dispose?.();\n    };\n  };\n}\n\nfunction normalizeOptionalArgs<TArgs>(\n  args: [] | [TArgs] | readonly unknown[]\n): TArgs {\n  return (args[0] ?? {}) as TArgs;\n}\n"],"mappings":";;;AA2BA,MAAM,yBAAyB,OAAO,iBAAiB;;;;AAKvD,SAAgB,iBAAiB,QAAsC;AACrE,YAAW,wBAAwB,OAAO;AAC1C,QAAO;;;;;AAMT,SAAgB,mBAAkC;CAChD,MAAM,SAAS,WAAsC,uBAAuB;AAC5E,KAAI,CAAC,OACH,OAAM,IAAI,MACR,+DACD;AAEH,QAAO;;;;;AAMT,SAAgB,iBACd,WACA,GAAG,MAC2D;AAC9D,QAAO,uBAAuB,kBAAkB,EAAE,WAAW,GAAG,KAAK;;;;;AAMvE,SAAgB,uBAGd,QACA,WACA,GAAG,MAC2D;AAE9D,QAAO,SACL;EACE,MAAM,KAAA;EACN,OAAO,KAAA;EACP,QAAQ;EACT,EACD,sBAAsB,QAAQ,WAPT,sBAAsB,KAAK,CAOQ,CACzD;;;;;AAMH,SAAgB,eAGd,WAGuC;CACvC,MAAM,SAAS,kBAAkB;AACjC,SAAQ,GAAG,SACT,OAAO,SAAS,WAAW,sBAAsB,KAAK,CAAC;;;;;AAQ3D,SAAgB,aACd,WAGuC;CACvC,MAAM,SAAS,kBAAkB;AACjC,SAAQ,GAAG,SACT,OAAO,OAAO,WAAW,sBAAsB,KAAK,CAAC;;AAKzD,SAAS,sBACP,QACA,WACA,MACuE;AACvE,SACE,QACG;EACH,MAAM,QAAQ,OAAO,WAAW,WAAW,KAAK;EAGhD,MAAM,aAAa;GACjB,MAAM,QAAQ,MAAM,iBAAiB;AACrC,OAAI;IACF,MAAM,MAAM,kBAAkB;IAC9B;IACA,QAAQ,QAAQ,UAAU;IAC3B,CAAC;;AAEJ,QAAM;EACN,MAAM,cAAc,MAAM,SAAS,KAAK;AACxC,eAAa;AACX,gBAAa;AACb,SAAM,WAAW;;;;AAKvB,SAAS,sBACP,MACO;AACP,QAAQ,KAAK,MAAM,EAAE"}

package/dist/svelte.d.ts

@@ -0,0 +1,2 @@
+import { OptionalArgsTuple, SyncoreQueryStoreState, createAction, createClientQueryStore, createMutation, createQueryStore, getSyncoreClient, setSyncoreClient } from "./svelte/src/index.js";
+export { OptionalArgsTuple, SyncoreQueryStoreState, createAction, createClientQueryStore, createMutation, createQueryStore, getSyncoreClient, setSyncoreClient };

package/dist/svelte.js

@@ -0,0 +1,2 @@
+import { createAction, createClientQueryStore, createMutation, createQueryStore, getSyncoreClient, setSyncoreClient } from "./svelte/src/index.js";
+export { createAction, createClientQueryStore, createMutation, createQueryStore, getSyncoreClient, setSyncoreClient };

package/package.json

@@ -0,0 +1,152 @@
+{
+  "name": "syncorejs",
+  "version": "0.1.0",
+  "description": "Local-first reactive backend toolkit for offline apps",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "bin": {
+    "syncorejs": "./dist/cli.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/JPSAUD501/Syncore.git",
+    "directory": "packages/syncore"
+  },
+  "homepage": "https://github.com/JPSAUD501/Syncore#readme",
+  "bugs": {
+    "url": "https://github.com/JPSAUD501/Syncore/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "exports": {
+    ".": {
+      "default": "./dist/index.js",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./cli": {
+      "default": "./dist/cli.js",
+      "types": "./dist/cli.d.ts",
+      "import": "./dist/cli.js"
+    },
+    "./browser": {
+      "default": "./dist/browser.js",
+      "types": "./dist/browser.d.ts",
+      "import": "./dist/browser.js"
+    },
+    "./browser/react": {
+      "default": "./dist/browser-react.js",
+      "types": "./dist/browser-react.d.ts",
+      "import": "./dist/browser-react.js"
+    },
+    "./react": {
+      "default": "./dist/react.js",
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.js"
+    },
+    "./svelte": {
+      "default": "./dist/svelte.js",
+      "types": "./dist/svelte.d.ts",
+      "import": "./dist/svelte.js"
+    },
+    "./expo": {
+      "default": "./dist/expo.js",
+      "types": "./dist/expo.d.ts",
+      "import": "./dist/expo.js"
+    },
+    "./expo/react": {
+      "default": "./dist/expo-react.js",
+      "types": "./dist/expo-react.d.ts",
+      "import": "./dist/expo-react.js"
+    },
+    "./node": {
+      "default": "./dist/node.js",
+      "types": "./dist/node.d.ts",
+      "import": "./dist/node.js"
+    },
+    "./node/ipc": {
+      "default": "./dist/node-ipc.js",
+      "types": "./dist/node-ipc.d.ts",
+      "import": "./dist/node-ipc.js"
+    },
+    "./node/ipc/react": {
+      "default": "./dist/node-ipc-react.js",
+      "types": "./dist/node-ipc-react.d.ts",
+      "import": "./dist/node-ipc-react.js"
+    },
+    "./next": {
+      "default": "./dist/next.js",
+      "types": "./dist/next.d.ts",
+      "import": "./dist/next.js"
+    },
+    "./next/config": {
+      "default": "./dist/next-config.js",
+      "types": "./dist/next-config.d.ts",
+      "import": "./dist/next-config.js"
+    }
+  },
+  "scripts": {
+    "build": "tsdown --config tsdown.config.ts && tsx ../../scripts/vendor-syncore-internals.ts",
+    "build:deps": "bun run --filter @syncore/core build && bun run --filter @syncore/schema build && bun run --filter @syncore/devtools-protocol build && bun run --filter @syncore/react build && bun run --filter @syncore/platform-web build && bun run --filter @syncore/platform-node build && bun run --filter @syncore/platform-expo build && bun run --filter @syncore/next build && bun run --filter @syncore/svelte build",
+    "build:standalone": "bun run build:deps && bun run build",
+    "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
+    "lint": "eslint src --ext .ts,.tsx",
+    "test": "vitest run --passWithNoTests",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "commander": "^13.1.0",
+    "date-fns-tz": "^3.2.0",
+    "sql.js": "^1.14.1",
+    "tsx": "^4.19.3",
+    "ws": "^8.18.0"
+  },
+  "peerDependencies": {
+    "expo-file-system": "^55.0.10",
+    "expo-sqlite": "^55.0.10",
+    "next": "^15.0.0",
+    "react": "^18.3.0 || ^19.0.0",
+    "react-dom": "^18.3.0 || ^19.0.0",
+    "svelte": "^5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "expo-file-system": {
+      "optional": true
+    },
+    "expo-sqlite": {
+      "optional": true
+    },
+    "next": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    },
+    "svelte": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@syncore/core": "workspace:*",
+    "@syncore/devtools-protocol": "workspace:*",
+    "@syncore/next": "workspace:*",
+    "@syncore/platform-expo": "workspace:*",
+    "@syncore/platform-node": "workspace:*",
+    "@syncore/platform-web": "workspace:*",
+    "@syncore/react": "workspace:*",
+    "@syncore/schema": "workspace:*",
+    "@syncore/svelte": "workspace:*"
+  }
+}