@syntrologie/adapt-gamification 0.0.0-semantically-released

package/dist/cdn.d.ts

@@ -0,0 +1,31 @@
+/**
+ * CDN Entry Point for Adaptive Gamification
+ *
+ * This module is bundled for CDN delivery and self-registers with the global
+ * SynOS app registry when loaded dynamically via the AppLoader.
+ */
+/**
+ * App manifest for registry registration.
+ * Follows the AppManifest interface expected by AppLoader/AppRegistry.
+ */
+export declare const manifest: {
+    id: string;
+    version: string;
+    name: string;
+    description: string;
+    runtime: {
+        actions: {
+            kind: "gamification:awardBadge" | "gamification:addPoints";
+            executor: import("./types").ActionExecutor<import("./runtime").AwardBadgeAction> | import("./types").ActionExecutor<import("./runtime").AddPointsAction>;
+        }[];
+        events: {
+            names: string[];
+            handler: (_event: unknown, _ctx: unknown) => void;
+        }[];
+    };
+    metadata: {
+        isBuiltIn: boolean;
+    };
+};
+export default manifest;
+//# sourceMappingURL=cdn.d.ts.map

package/dist/cdn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdn.d.ts","sourceRoot":"","sources":["../src/cdn.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;GAGG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;CAepB,CAAC;AAaF,eAAe,QAAQ,CAAC"}

package/dist/cdn.js

@@ -0,0 +1,38 @@
+/**
+ * CDN Entry Point for Adaptive Gamification
+ *
+ * This module is bundled for CDN delivery and self-registers with the global
+ * SynOS app registry when loaded dynamically via the AppLoader.
+ */
+import { executors, eventHandlers, runtime } from './runtime';
+/**
+ * App manifest for registry registration.
+ * Follows the AppManifest interface expected by AppLoader/AppRegistry.
+ */
+export const manifest = {
+    id: 'gamification',
+    version: runtime.version,
+    name: runtime.name,
+    description: runtime.description,
+    runtime: {
+        actions: executors.map(({ kind, executor }) => ({
+            kind,
+            executor,
+        })),
+        events: eventHandlers,
+    },
+    metadata: {
+        isBuiltIn: false,
+    },
+};
+/**
+ * Self-register with global registry if available.
+ * This happens when loaded via script tag (UMD).
+ */
+if (typeof window !== 'undefined') {
+    const globalRegistry = window.__SYNOS_APP_REGISTRY__;
+    if (globalRegistry && typeof globalRegistry.register === 'function') {
+        globalRegistry.register(manifest);
+    }
+}
+export default manifest;

package/dist/editor.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Adaptive Gamification - Editor Module
+ *
+ * Editor panel for configuring gamification features.
+ */
+import type { EditorPanelProps } from './types';
+/**
+ * Gamification editor panel component.
+ */
+export declare function GamificationEditor({ config: _config, onChange: _onChange, editor: _editor, }: EditorPanelProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Editor module configuration.
+ */
+export declare const editor: {
+    panel: {
+        title: string;
+        icon: string;
+        description: string;
+    };
+    component: typeof GamificationEditor;
+};
+//# sourceMappingURL=editor.d.ts.map

package/dist/editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor.d.ts","sourceRoot":"","sources":["../src/editor.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,SAAS,EACnB,MAAM,EAAE,OAAO,GAChB,EAAE,gBAAgB,2CAOlB;AAED;;GAEG;AACH,eAAO,MAAM,MAAM;;;;;;;CAOlB,CAAC"}

package/dist/editor.js

@@ -0,0 +1,18 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Gamification editor panel component.
+ */
+export function GamificationEditor({ config: _config, onChange: _onChange, editor: _editor, }) {
+    return (_jsxs("div", { className: "syntro-gamification-editor", children: [_jsx("p", { children: "Gamification editor coming soon..." }), _jsx("p", { children: "Configure badges, points, rewards, and leaderboards." })] }));
+}
+/**
+ * Editor module configuration.
+ */
+export const editor = {
+    panel: {
+        title: 'Gamification',
+        icon: '🎮',
+        description: 'Badges, rewards, and engagement',
+    },
+    component: GamificationEditor,
+};

package/dist/runtime.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Adaptive Gamification - Runtime Module
+ *
+ * Gamification actions: awardBadge, addPoints.
+ * Provides gamification features like badges, points, and rewards.
+ */
+import type { ActionExecutor } from './types';
+/**
+ * Award badge action
+ */
+export interface AwardBadgeAction {
+    kind: 'gamification:awardBadge';
+    badgeId: string;
+    anchorId?: string;
+    label?: string;
+}
+/**
+ * Add points action
+ */
+export interface AddPointsAction {
+    kind: 'gamification:addPoints';
+    points: number;
+    reason?: string;
+    label?: string;
+}
+/**
+ * Execute an awardBadge action
+ *
+ * Note: This executor uses publishEvent to track badge awards.
+ * State management is handled at the app level via AppContext,
+ * not at the action executor level.
+ */
+export declare const executeAwardBadge: ActionExecutor<AwardBadgeAction>;
+/**
+ * Execute an addPoints action
+ *
+ * Note: This executor uses publishEvent to track points.
+ * State management is handled at the app level via AppContext,
+ * not at the action executor level.
+ */
+export declare const executeAddPoints: ActionExecutor<AddPointsAction>;
+/**
+ * Event handler for auto-awarding badges based on triggers.
+ */
+export declare const badgeTriggerHandler: {
+    names: string[];
+    handler: (_event: unknown, _ctx: unknown) => void;
+};
+/**
+ * All executors provided by this app.
+ * These are registered with the runtime's ExecutorRegistry.
+ */
+export declare const executors: readonly [{
+    readonly kind: "gamification:awardBadge";
+    readonly executor: ActionExecutor<AwardBadgeAction>;
+}, {
+    readonly kind: "gamification:addPoints";
+    readonly executor: ActionExecutor<AddPointsAction>;
+}];
+/**
+ * Event handlers provided by this app.
+ */
+export declare const eventHandlers: {
+    names: string[];
+    handler: (_event: unknown, _ctx: unknown) => void;
+}[];
+/**
+ * App runtime manifest.
+ */
+export declare const runtime: {
+    id: string;
+    version: string;
+    name: string;
+    description: string;
+    executors: readonly [{
+        readonly kind: "gamification:awardBadge";
+        readonly executor: ActionExecutor<AwardBadgeAction>;
+    }, {
+        readonly kind: "gamification:addPoints";
+        readonly executor: ActionExecutor<AddPointsAction>;
+    }];
+    eventHandlers: {
+        names: string[];
+        handler: (_event: unknown, _ctx: unknown) => void;
+    }[];
+};
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAkB,cAAc,EAAE,MAAM,SAAS,CAAC;AAM9D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,yBAAyB,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,wBAAwB,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,EAAE,cAAc,CAAC,gBAAgB,CAiB9D,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,EAAE,cAAc,CAAC,eAAe,CAkB5D,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,mBAAmB;;sBAEZ,OAAO,QAAQ,OAAO;CAKzC,CAAC;AAMF;;;GAGG;AACH,eAAO,MAAM,SAAS;;;;;;EAGZ,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,aAAa;;sBAvBN,OAAO,QAAQ,OAAO;GAuBQ,CAAC;AAEnD;;GAEG;AACH,eAAO,MAAM,OAAO;;;;;;;;;;;;;;0BA5BA,OAAO,QAAQ,OAAO;;CAmCzC,CAAC"}

package/dist/runtime.js

@@ -0,0 +1,90 @@
+/**
+ * Adaptive Gamification - Runtime Module
+ *
+ * Gamification actions: awardBadge, addPoints.
+ * Provides gamification features like badges, points, and rewards.
+ */
+// ============================================================================
+// Executors
+// ============================================================================
+/**
+ * Execute an awardBadge action
+ *
+ * Note: This executor uses publishEvent to track badge awards.
+ * State management is handled at the app level via AppContext,
+ * not at the action executor level.
+ */
+export const executeAwardBadge = async (action, context) => {
+    const { badgeId } = action;
+    // Emit telemetry event (state management handled at app level)
+    context.publishEvent('gamification.badge_awarded', {
+        badgeId,
+        awardedAt: Date.now(),
+    });
+    return {
+        cleanup: () => {
+            // Badge awards are permanent, no cleanup needed
+        },
+    };
+};
+/**
+ * Execute an addPoints action
+ *
+ * Note: This executor uses publishEvent to track points.
+ * State management is handled at the app level via AppContext,
+ * not at the action executor level.
+ */
+export const executeAddPoints = async (action, context) => {
+    const { points, reason } = action;
+    // Emit telemetry event (state management handled at app level)
+    context.publishEvent('gamification.points_added', {
+        points,
+        reason,
+        timestamp: Date.now(),
+    });
+    return {
+        cleanup: () => {
+            // Points are permanent, no cleanup needed
+        },
+    };
+};
+// ============================================================================
+// Event Handlers
+// ============================================================================
+/**
+ * Event handler for auto-awarding badges based on triggers.
+ */
+export const badgeTriggerHandler = {
+    names: ['page_view', 'button_click'],
+    handler: (_event, _ctx) => {
+        // Auto-award badges based on event triggers
+        // This would check badge trigger conditions in the config
+        console.log('[Gamification] Event received for badge trigger check');
+    },
+};
+// ============================================================================
+// Executor Definitions for Registration
+// ============================================================================
+/**
+ * All executors provided by this app.
+ * These are registered with the runtime's ExecutorRegistry.
+ */
+export const executors = [
+    { kind: 'gamification:awardBadge', executor: executeAwardBadge },
+    { kind: 'gamification:addPoints', executor: executeAddPoints },
+];
+/**
+ * Event handlers provided by this app.
+ */
+export const eventHandlers = [badgeTriggerHandler];
+/**
+ * App runtime manifest.
+ */
+export const runtime = {
+    id: 'adaptive-gamification',
+    version: '1.0.0',
+    name: 'Gamification',
+    description: 'Badges, rewards, points, and engagement mechanics',
+    executors,
+    eventHandlers,
+};

package/dist/schema.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Adaptive Gamification - Config Schema
+ *
+ * Zod schema for validating gamification app configuration.
+ */
+import { z } from 'zod';
+/**
+ * Gamification app config schema.
+ */
+export declare const configSchema: z.ZodObject<{
+    badges: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        icon: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        trigger: z.ZodObject<{
+            event: z.ZodString;
+            conditions: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            event: string;
+            conditions?: unknown[] | undefined;
+        }, {
+            event: string;
+            conditions?: unknown[] | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        name: string;
+        icon: string;
+        trigger: {
+            event: string;
+            conditions?: unknown[] | undefined;
+        };
+        description?: string | undefined;
+    }, {
+        id: string;
+        name: string;
+        icon: string;
+        trigger: {
+            event: string;
+            conditions?: unknown[] | undefined;
+        };
+        description?: string | undefined;
+    }>, "many">>;
+    leaderboard: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        refreshInterval: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
+        refreshInterval: number;
+    }, {
+        enabled?: boolean | undefined;
+        refreshInterval?: number | undefined;
+    }>>;
+    points: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        multiplier: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
+        multiplier: number;
+    }, {
+        enabled?: boolean | undefined;
+        multiplier?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    badges: {
+        id: string;
+        name: string;
+        icon: string;
+        trigger: {
+            event: string;
+            conditions?: unknown[] | undefined;
+        };
+        description?: string | undefined;
+    }[];
+    points?: {
+        enabled: boolean;
+        multiplier: number;
+    } | undefined;
+    leaderboard?: {
+        enabled: boolean;
+        refreshInterval: number;
+    } | undefined;
+}, {
+    points?: {
+        enabled?: boolean | undefined;
+        multiplier?: number | undefined;
+    } | undefined;
+    badges?: {
+        id: string;
+        name: string;
+        icon: string;
+        trigger: {
+            event: string;
+            conditions?: unknown[] | undefined;
+        };
+        description?: string | undefined;
+    }[] | undefined;
+    leaderboard?: {
+        enabled?: boolean | undefined;
+        refreshInterval?: number | undefined;
+    } | undefined;
+}>;
+export type GamificationConfig = z.infer<typeof configSchema>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAwBxB;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EASvB,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC"}

package/dist/schema.js

@@ -0,0 +1,39 @@
+/**
+ * Adaptive Gamification - Config Schema
+ *
+ * Zod schema for validating gamification app configuration.
+ */
+import { z } from 'zod';
+/**
+ * Badge definition schema.
+ */
+const badgeSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    icon: z.string(),
+    description: z.string().optional(),
+    trigger: z.object({
+        event: z.string(),
+        conditions: z.array(z.unknown()).optional(),
+    }),
+});
+/**
+ * Leaderboard configuration schema.
+ */
+const leaderboardConfigSchema = z.object({
+    enabled: z.boolean().default(false),
+    refreshInterval: z.number().default(60000),
+});
+/**
+ * Gamification app config schema.
+ */
+export const configSchema = z.object({
+    badges: z.array(badgeSchema).default([]),
+    leaderboard: leaderboardConfigSchema.optional(),
+    points: z
+        .object({
+        enabled: z.boolean().default(false),
+        multiplier: z.number().default(1),
+    })
+        .optional(),
+});

package/dist/types.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Types from @syntrologie/runtime-sdk
+ *
+ * Minimal type definitions for building this app independently.
+ * These match the types exported from @syntrologie/runtime-sdk/types.
+ */
+export interface EditorPanelProps {
+    config: Record<string, unknown>;
+    onChange: (config: Record<string, unknown>) => void;
+    editor: {
+        setDirty: (dirty: boolean) => void;
+        navigateHome: () => Promise<boolean>;
+        save: () => Promise<void>;
+        publish: (captureScreenshot?: boolean) => Promise<void>;
+    };
+    platformClient?: unknown;
+}
+export type ExecutorCleanup = () => void | Promise<void>;
+export type ExecutorUpdate = (changes: Record<string, unknown>) => void | Promise<void>;
+export interface ExecutorResult {
+    cleanup: ExecutorCleanup;
+    updateFn?: ExecutorUpdate;
+}
+export interface ExecutorContext {
+    overlayRoot: HTMLElement;
+    resolveAnchor: (anchorId: string) => HTMLElement | null;
+    generateId: () => string;
+    publishEvent: (name: string, props?: Record<string, unknown>) => void;
+    adaptiveId?: string;
+}
+export type ActionExecutor<T> = (action: T, context: ExecutorContext) => Promise<ExecutorResult>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACpD,MAAM,EAAE;QACN,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;QACnC,YAAY,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QAC1B,OAAO,EAAE,CAAC,iBAAiB,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KACzD,CAAC;IACF,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAMD,MAAM,MAAM,eAAe,GAAG,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AACzD,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAExF,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,eAAe,CAAC;IACzB,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,WAAW,CAAC;IACzB,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,WAAW,GAAG,IAAI,CAAC;IACxD,UAAU,EAAE,MAAM,MAAM,CAAC;IACzB,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC"}

package/dist/types.js

@@ -0,0 +1,7 @@
+/**
+ * Types from @syntrologie/runtime-sdk
+ *
+ * Minimal type definitions for building this app independently.
+ * These match the types exported from @syntrologie/runtime-sdk/types.
+ */
+export {};

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@syntrologie/adapt-gamification",
+  "version": "0.0.0-semantically-released",
+  "description": "Adaptive Gamification app - Badges, rewards, points, and engagement mechanics",
+  "license": "Proprietary",
+  "private": false,
+  "author": "Syntrologie <eng@syntrologie.com>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/SyntropyForge/amazing-demos.git",
+    "directory": "tech-core/sdks/adaptives/adaptive-gamification"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "exports": {
+    "./runtime": {
+      "types": "./dist/runtime.d.ts",
+      "import": "./dist/runtime.js"
+    },
+    "./schema": {
+      "types": "./dist/schema.d.ts",
+      "import": "./dist/schema.js"
+    },
+    "./editor": {
+      "types": "./dist/editor.d.ts",
+      "import": "./dist/editor.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist"
+  },
+  "peerDependencies": {
+    "@syntrologie/runtime-sdk": "^2.0.0",
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0",
+    "zod": "^3.0.0"
+  },
+  "devDependencies": {
+    "@types/react": "^18.0.0",
+    "typescript": "^5.0.0",
+    "zod": "^3.25.0"
+  }
+}