@voidhash/mimic 0.0.1-alpha.7 → 0.0.1-alpha.8

package/dist/Presence-DdMVKcOv.mjs

@@ -0,0 +1,110 @@
+import { t as __export } from "./chunk-CLMFDpHK.mjs";
+import { m as _defineProperty } from "./Document-CwiAFTIq.mjs";
+import * as Schema from "effect/Schema";
+
+//#region \0@oxc-project+runtime@0.103.0/helpers/objectSpread2.js
+function ownKeys(e, r) {
+	var t = Object.keys(e);
+	if (Object.getOwnPropertySymbols) {
+		var o = Object.getOwnPropertySymbols(e);
+		r && (o = o.filter(function(r$1) {
+			return Object.getOwnPropertyDescriptor(e, r$1).enumerable;
+		})), t.push.apply(t, o);
+	}
+	return t;
+}
+function _objectSpread2(e) {
+	for (var r = 1; r < arguments.length; r++) {
+		var t = null != arguments[r] ? arguments[r] : {};
+		r % 2 ? ownKeys(Object(t), !0).forEach(function(r$1) {
+			_defineProperty(e, r$1, t[r$1]);
+		}) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function(r$1) {
+			Object.defineProperty(e, r$1, Object.getOwnPropertyDescriptor(t, r$1));
+		});
+	}
+	return e;
+}
+
+//#endregion
+//#region src/Presence.ts
+/**
+* @since 0.0.1
+* Presence module for ephemeral per-connection state.
+* Used by both client and server for schema validation.
+*/
+var Presence_exports = /* @__PURE__ */ __export({
+	isValid: () => isValid,
+	make: () => make,
+	validate: () => validate,
+	validateSafe: () => validateSafe
+});
+/**
+* Creates a new Presence schema wrapper.
+*
+* @example
+* ```typescript
+* import { Presence } from "@voidhash/mimic";
+* import { Schema } from "effect";
+*
+* const CursorPresence = Presence.make({
+*   schema: Schema.Struct({
+*     name: Schema.String,
+*     cursor: Schema.Struct({
+*       x: Schema.Number,
+*       y: Schema.Number,
+*     }),
+*   }),
+* });
+* ```
+*/
+const make = (options) => ({
+	_tag: "Presence",
+	schema: options.schema,
+	_Data: void 0
+});
+/**
+* Validates unknown data against a Presence schema.
+* Throws a ParseError if validation fails.
+*
+* @param presence - The Presence instance with the schema
+* @param data - Unknown data to validate
+* @returns The validated and typed data
+* @throws ParseError if validation fails
+*/
+const validate = (presence, data) => {
+	return Schema.decodeUnknownSync(presence.schema)(data);
+};
+/**
+* Safely validates unknown data against a Presence schema.
+* Returns undefined if validation fails instead of throwing.
+*
+* @param presence - The Presence instance with the schema
+* @param data - Unknown data to validate
+* @returns The validated data or undefined if invalid
+*/
+const validateSafe = (presence, data) => {
+	try {
+		return Schema.decodeUnknownSync(presence.schema)(data);
+	} catch (_unused) {
+		return;
+	}
+};
+/**
+* Checks if unknown data is valid according to a Presence schema.
+*
+* @param presence - The Presence instance with the schema
+* @param data - Unknown data to check
+* @returns true if valid, false otherwise
+*/
+const isValid = (presence, data) => {
+	try {
+		Schema.decodeUnknownSync(presence.schema)(data);
+		return true;
+	} catch (_unused2) {
+		return false;
+	}
+};
+
+//#endregion
+export { validate as n, _objectSpread2 as r, Presence_exports as t };
+//# sourceMappingURL=Presence-DdMVKcOv.mjs.map

package/dist/Presence-DdMVKcOv.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Presence-DdMVKcOv.mjs","names":[],"sources":["../src/Presence.ts"],"sourcesContent":["/**\n * @since 0.0.1\n * Presence module for ephemeral per-connection state.\n * Used by both client and server for schema validation.\n */\nimport * as Schema from \"effect/Schema\";\n\n// =============================================================================\n// Presence Types\n// =============================================================================\n\n/**\n * A Presence schema wrapper that holds an Effect Schema for validation.\n * This is used by both client and server to validate presence data.\n */\nexport interface Presence<TData> {\n  readonly _tag: \"Presence\";\n  /** The Effect Schema used for validation */\n  readonly schema: Schema.Schema<TData>;\n  /** Branded type marker for inference */\n  readonly _Data: TData;\n}\n\n/**\n * Options for creating a Presence instance.\n */\nexport interface PresenceOptions<TData> {\n  /** The Effect Schema defining the presence data structure */\n  readonly schema: Schema.Schema<TData>;\n}\n\n/**\n * Infer the data type from a Presence instance.\n */\nexport type Infer<P extends Presence<any>> = P[\"_Data\"];\n\n/**\n * Any Presence type (for generic constraints).\n */\nexport type AnyPresence = Presence<any>;\n\n// =============================================================================\n// Presence Entry (for storage/transport)\n// =============================================================================\n\n/**\n * A presence entry as stored/transmitted.\n */\nexport interface PresenceEntry<TData = unknown> {\n  /** The presence data */\n  readonly data: TData;\n  /** Optional user ID from authentication */\n  readonly userId?: string;\n}\n\n// =============================================================================\n// Factory Function\n// =============================================================================\n\n/**\n * Creates a new Presence schema wrapper.\n *\n * @example\n * ```typescript\n * import { Presence } from \"@voidhash/mimic\";\n * import { Schema } from \"effect\";\n *\n * const CursorPresence = Presence.make({\n *   schema: Schema.Struct({\n *     name: Schema.String,\n *     cursor: Schema.Struct({\n *       x: Schema.Number,\n *       y: Schema.Number,\n *     }),\n *   }),\n * });\n * ```\n */\nexport const make = <TData,>(options: PresenceOptions<TData>): Presence<TData> => ({\n  _tag: \"Presence\",\n  schema: options.schema,\n  _Data: undefined as unknown as TData,\n});\n\n// =============================================================================\n// Validation Functions\n// =============================================================================\n\n/**\n * Validates unknown data against a Presence schema.\n * Throws a ParseError if validation fails.\n *\n * @param presence - The Presence instance with the schema\n * @param data - Unknown data to validate\n * @returns The validated and typed data\n * @throws ParseError if validation fails\n */\nexport const validate = <TData,>(\n  presence: Presence<TData>,\n  data: unknown\n): TData => {\n  return Schema.decodeUnknownSync(presence.schema)(data);\n};\n\n/**\n * Safely validates unknown data against a Presence schema.\n * Returns undefined if validation fails instead of throwing.\n *\n * @param presence - The Presence instance with the schema\n * @param data - Unknown data to validate\n * @returns The validated data or undefined if invalid\n */\nexport const validateSafe = <TData,>(\n  presence: Presence<TData>,\n  data: unknown\n): TData | undefined => {\n  try {\n    return Schema.decodeUnknownSync(presence.schema)(data);\n  } catch {\n    return undefined;\n  }\n};\n\n/**\n * Checks if unknown data is valid according to a Presence schema.\n *\n * @param presence - The Presence instance with the schema\n * @param data - Unknown data to check\n * @returns true if valid, false otherwise\n */\nexport const isValid = <TData,>(\n  presence: Presence<TData>,\n  data: unknown\n): data is TData => {\n  try {\n    Schema.decodeUnknownSync(presence.schema)(data);\n    return true;\n  } catch {\n    return false;\n  }\n};\n\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8EA,MAAa,QAAgB,aAAsD;CACjF,MAAM;CACN,QAAQ,QAAQ;CAChB,OAAO;CACR;;;;;;;;;;AAeD,MAAa,YACX,UACA,SACU;AACV,QAAO,OAAO,kBAAkB,SAAS,OAAO,CAAC,KAAK;;;;;;;;;;AAWxD,MAAa,gBACX,UACA,SACsB;AACtB,KAAI;AACF,SAAO,OAAO,kBAAkB,SAAS,OAAO,CAAC,KAAK;mBAChD;AACN;;;;;;;;;;AAWJ,MAAa,WACX,UACA,SACkB;AAClB,KAAI;AACF,SAAO,kBAAkB,SAAS,OAAO,CAAC,KAAK;AAC/C,SAAO;oBACD;AACN,SAAO"}

package/dist/Presence-N8u7Eppr.d.mts

@@ -0,0 +1,91 @@
+import * as Schema from "effect/Schema";
+
+//#region src/Presence.d.ts
+declare namespace Presence_d_exports {
+  export { AnyPresence, Infer, Presence, PresenceEntry, PresenceOptions, isValid, make, validate, validateSafe };
+}
+/**
+ * A Presence schema wrapper that holds an Effect Schema for validation.
+ * This is used by both client and server to validate presence data.
+ */
+interface Presence<TData> {
+  readonly _tag: "Presence";
+  /** The Effect Schema used for validation */
+  readonly schema: Schema.Schema<TData>;
+  /** Branded type marker for inference */
+  readonly _Data: TData;
+}
+/**
+ * Options for creating a Presence instance.
+ */
+interface PresenceOptions<TData> {
+  /** The Effect Schema defining the presence data structure */
+  readonly schema: Schema.Schema<TData>;
+}
+/**
+ * Infer the data type from a Presence instance.
+ */
+type Infer<P extends Presence<any>> = P["_Data"];
+/**
+ * Any Presence type (for generic constraints).
+ */
+type AnyPresence = Presence<any>;
+/**
+ * A presence entry as stored/transmitted.
+ */
+interface PresenceEntry<TData = unknown> {
+  /** The presence data */
+  readonly data: TData;
+  /** Optional user ID from authentication */
+  readonly userId?: string;
+}
+/**
+ * Creates a new Presence schema wrapper.
+ *
+ * @example
+ * ```typescript
+ * import { Presence } from "@voidhash/mimic";
+ * import { Schema } from "effect";
+ *
+ * const CursorPresence = Presence.make({
+ *   schema: Schema.Struct({
+ *     name: Schema.String,
+ *     cursor: Schema.Struct({
+ *       x: Schema.Number,
+ *       y: Schema.Number,
+ *     }),
+ *   }),
+ * });
+ * ```
+ */
+declare const make: <TData>(options: PresenceOptions<TData>) => Presence<TData>;
+/**
+ * Validates unknown data against a Presence schema.
+ * Throws a ParseError if validation fails.
+ *
+ * @param presence - The Presence instance with the schema
+ * @param data - Unknown data to validate
+ * @returns The validated and typed data
+ * @throws ParseError if validation fails
+ */
+declare const validate: <TData>(presence: Presence<TData>, data: unknown) => TData;
+/**
+ * Safely validates unknown data against a Presence schema.
+ * Returns undefined if validation fails instead of throwing.
+ *
+ * @param presence - The Presence instance with the schema
+ * @param data - Unknown data to validate
+ * @returns The validated data or undefined if invalid
+ */
+declare const validateSafe: <TData>(presence: Presence<TData>, data: unknown) => TData | undefined;
+/**
+ * Checks if unknown data is valid according to a Presence schema.
+ *
+ * @param presence - The Presence instance with the schema
+ * @param data - Unknown data to check
+ * @returns true if valid, false otherwise
+ */
+declare const isValid: <TData>(presence: Presence<TData>, data: unknown) => data is TData;
+//#endregion
+export { Presence_d_exports as i, Infer as n, PresenceEntry as r, AnyPresence as t };
+//# sourceMappingURL=Presence-N8u7Eppr.d.mts.map

package/dist/Presence-N8u7Eppr.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Presence-N8u7Eppr.d.mts","names":[],"sources":["../src/Presence.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;UAeiB;;;mBAGE,MAAA,CAAO,OAAO;;EAHhB,SAAA,KAAQ,EAKP,KALO;;;;;AAWR,UAAA,eAAe,CAAA,KAAA,CAEC,CAAA;EAMrB;EAKA,SAAA,MAAW,EAXJ,MAAA,CAAO,MAWA,CAXO,KAWC,CAAA;AASlC;AA8BA;;;AAAwE,KA5C5D,KA4C4D,CAAA,UA5C5C,QA4C4C,CAAA,GAAA,CAAA,CAAA,GA5C3B,CA4C2B,CAAA,OAAA,CAAA;;;AAmBxE;AACqB,KA3DT,WAAA,GAAc,QA2DL,CAAA,GAAA,CAAA;;;;AAcR,UAhEI,aAyEhB,CAAA,QAAA,OAAA,CAAA,CAAA;EARoB;EAAT,SAAA,IAAA,EA/DK,KA+DL;EAET;EAAK,SAAA,MAAA,CAAA,EAAA,MAAA;AAeR;;;;;;;;;;;;;;;;;;;;cApDa,uBAAyB,gBAAgB,WAAS,SAAS;;;;;;;;;;cAmB3D,4BACD,SAAS,0BAElB;;;;;;;;;cAYU,gCACD,SAAS,0BAElB;;;;;;;;cAeU,2BACD,SAAS,kCAEV"}

package/dist/Presence-gWrmGBeu.cjs

@@ -0,0 +1,126 @@
+const require_Document = require('./Document-ChuFrTk1.cjs');
+let effect_Schema = require("effect/Schema");
+effect_Schema = require_Document.__toESM(effect_Schema);
+
+//#region \0@oxc-project+runtime@0.103.0/helpers/objectSpread2.js
+function ownKeys(e, r) {
+	var t = Object.keys(e);
+	if (Object.getOwnPropertySymbols) {
+		var o = Object.getOwnPropertySymbols(e);
+		r && (o = o.filter(function(r$1) {
+			return Object.getOwnPropertyDescriptor(e, r$1).enumerable;
+		})), t.push.apply(t, o);
+	}
+	return t;
+}
+function _objectSpread2(e) {
+	for (var r = 1; r < arguments.length; r++) {
+		var t = null != arguments[r] ? arguments[r] : {};
+		r % 2 ? ownKeys(Object(t), !0).forEach(function(r$1) {
+			require_Document._defineProperty(e, r$1, t[r$1]);
+		}) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function(r$1) {
+			Object.defineProperty(e, r$1, Object.getOwnPropertyDescriptor(t, r$1));
+		});
+	}
+	return e;
+}
+
+//#endregion
+//#region src/Presence.ts
+/**
+* @since 0.0.1
+* Presence module for ephemeral per-connection state.
+* Used by both client and server for schema validation.
+*/
+var Presence_exports = /* @__PURE__ */ require_Document.__export({
+	isValid: () => isValid,
+	make: () => make,
+	validate: () => validate,
+	validateSafe: () => validateSafe
+});
+/**
+* Creates a new Presence schema wrapper.
+*
+* @example
+* ```typescript
+* import { Presence } from "@voidhash/mimic";
+* import { Schema } from "effect";
+*
+* const CursorPresence = Presence.make({
+*   schema: Schema.Struct({
+*     name: Schema.String,
+*     cursor: Schema.Struct({
+*       x: Schema.Number,
+*       y: Schema.Number,
+*     }),
+*   }),
+* });
+* ```
+*/
+const make = (options) => ({
+	_tag: "Presence",
+	schema: options.schema,
+	_Data: void 0
+});
+/**
+* Validates unknown data against a Presence schema.
+* Throws a ParseError if validation fails.
+*
+* @param presence - The Presence instance with the schema
+* @param data - Unknown data to validate
+* @returns The validated and typed data
+* @throws ParseError if validation fails
+*/
+const validate = (presence, data) => {
+	return effect_Schema.decodeUnknownSync(presence.schema)(data);
+};
+/**
+* Safely validates unknown data against a Presence schema.
+* Returns undefined if validation fails instead of throwing.
+*
+* @param presence - The Presence instance with the schema
+* @param data - Unknown data to validate
+* @returns The validated data or undefined if invalid
+*/
+const validateSafe = (presence, data) => {
+	try {
+		return effect_Schema.decodeUnknownSync(presence.schema)(data);
+	} catch (_unused) {
+		return;
+	}
+};
+/**
+* Checks if unknown data is valid according to a Presence schema.
+*
+* @param presence - The Presence instance with the schema
+* @param data - Unknown data to check
+* @returns true if valid, false otherwise
+*/
+const isValid = (presence, data) => {
+	try {
+		effect_Schema.decodeUnknownSync(presence.schema)(data);
+		return true;
+	} catch (_unused2) {
+		return false;
+	}
+};
+
+//#endregion
+Object.defineProperty(exports, 'Presence_exports', {
+  enumerable: true,
+  get: function () {
+    return Presence_exports;
+  }
+});
+Object.defineProperty(exports, '_objectSpread2', {
+  enumerable: true,
+  get: function () {
+    return _objectSpread2;
+  }
+});
+Object.defineProperty(exports, 'validate', {
+  enumerable: true,
+  get: function () {
+    return validate;
+  }
+});