@zyacreatives/shared 2.1.48 → 2.1.50

package/.specstory/.project.json

@@ -0,0 +1,6 @@
+{
+  "workspace_id": "597f-9398-c489-f5fb",
+  "workspace_id_at": "2026-01-09T09:19:55.255Z",
+  "project_name": "shared",
+  "cloud_sync": false
+}

package/.specstory/.what-is-this.md

@@ -0,0 +1,69 @@
+# SpecStory Artifacts Directory
+    
+This directory is automatically created and maintained by the SpecStory extension to preserve your AI chat history.
+    
+## What's Here?
+    
+- `.specstory/history`: Contains auto-saved markdown files of your AI coding sessions
+    - Each file represents a separate AI chat session
+    - If you enable auto-save, files are automatically updated as you work
+    - You can enable/disable the auto-save feature in the SpecStory settings, it is disabled by default
+- `.specstory/.project.json`: Contains the persistent project identity for the current workspace
+    - This file is only present if you enable AI rules derivation
+    - This is used to provide consistent project identity of your project, even as the workspace is moved or renamed
+- `.specstory/ai_rules_backups`: Contains backups of the `.cursor/rules/derived-cursor-rules.mdc` or the `.github/copilot-instructions.md` file
+    - Backups are automatically created each time the `.cursor/rules/derived-cursor-rules.mdc` or the `.github/copilot-instructions.md` file is updated
+    - You can enable/disable the AI Rules derivation feature in the SpecStory settings, it is disabled by default
+- `.specstory/.gitignore`: Contains directives to exclude non-essential contents of the `.specstory` directory from version control
+    - Add `/history` to exclude the auto-saved chat history from version control
+
+## Valuable Uses
+    
+- Capture: Keep your context window up-to-date when starting new Chat/Composer sessions via @ references
+- Search: For previous prompts and code snippets 
+- Learn: Meta-analyze your patterns and learn from your past experiences
+- Derive: Keep the AI on course with your past decisions by automatically deriving rules from your AI interactions
+    
+## Version Control
+    
+We recommend keeping this directory under version control to maintain a history of your AI interactions. However, if you prefer not to version these files, you can exclude them by adding this to your `.gitignore`:
+    
+```
+.specstory/**
+```
+
+We recommend __not__ keeping the `.specstory/ai_rules_backups` directory under version control if you are already using git to version your AI rules, and committing regularly. You can exclude it by adding this to your `.gitignore`:
+
+```
+.specstory/ai_rules_backups
+```
+
+## Searching Your Codebase
+    
+When searching your codebase, search results may include your previous AI coding interactions. To focus solely on your actual code files, you can exclude the AI interaction history from search results.
+    
+To exclude AI interaction history:
+    
+1. Open the "Find in Files" search in Cursor or VSCode (Cmd/Ctrl + Shift + F)
+2. Navigate to the "files to exclude" section
+3. Add the following pattern:
+    
+```
+.specstory/*
+```
+    
+This will ensure your searches only return results from your working codebase files.
+
+## Notes
+
+- Auto-save only works when Cursor or VSCode flushes sqlite database data to disk. This results in a small delay after the AI response is complete before SpecStory can save the history.
+
+## Settings
+    
+You can control auto-saving behavior in Cursor or VSCode:
+    
+1. Open Cursor/Code → Settings → VS Code Settings (Cmd/Ctrl + ,)
+2. Search for "SpecStory"
+3. Find "Auto Save" setting to enable/disable
+    
+Auto-save occurs when changes are detected in the sqlite database, or every 2 minutes as a safety net.

package/dist/schemas/activity.d.ts

@@ -0,0 +1,15 @@
+import z from "zod";
+export declare const ActivitySchema: z.ZodObject<{
+    activityId: z.ZodCUID2;
+    activityType: z.ZodEnum<{
+        readonly LIKE: "LIKE";
+        readonly UNLIKE: "UNLIKE";
+        readonly BOOKMARK: "BOOKMARK";
+        readonly UNBOOKMARK: "UNBOOKMARK";
+        readonly VIEW: "VIEW";
+    }>;
+    actorName: z.ZodString;
+    actorId: z.ZodString;
+    actorUsername: z.ZodString;
+    actorImageUrl: z.ZodOptional<z.ZodURL>;
+}, z.core.$strip>;

package/dist/schemas/activity.js

@@ -0,0 +1,19 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ActivitySchema = void 0;
+const zod_1 = __importDefault(require("zod"));
+const constants_1 = require("../constants");
+exports.ActivitySchema = zod_1.default.object({
+    activityId: zod_1.default.cuid2().openapi({
+        description: "Unique identifier for the bookmarked entity.",
+        title: "Entity ID",
+    }),
+    activityType: zod_1.default.enum(constants_1.ACTIVITY_TYPES),
+    actorName: zod_1.default.string(),
+    actorId: zod_1.default.string(),
+    actorUsername: zod_1.default.string(),
+    actorImageUrl: zod_1.default.url().optional(),
+});

package/dist/schemas/feed.d.ts

@@ -0,0 +1,8 @@
+import { z } from "@hono/zod-openapi";
+export declare const FeedTagsSchema: z.ZodObject<{
+    userId: z.ZodCUID2;
+    tags: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export declare const FeedTagsInputSchema: z.ZodObject<{
+    tags: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;

package/dist/schemas/feed.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FeedTagsInputSchema = exports.FeedTagsSchema = void 0;
+const zod_openapi_1 = require("@hono/zod-openapi");
+exports.FeedTagsSchema = zod_openapi_1.z.object({
+    userId: zod_openapi_1.z.cuid2(),
+    tags: zod_openapi_1.z.array(zod_openapi_1.z.string()),
+});
+exports.FeedTagsInputSchema = zod_openapi_1.z.object({
+    tags: zod_openapi_1.z.array(zod_openapi_1.z.string()),
+});

package/dist/schemas/index.d.ts

@@ -16,3 +16,6 @@ export * from "./job";
 export * from "./job-application";
 export * from "./user-strike";
 export * from "./notification";
+export * from "./feed";
+export * from "./bookmark";
+export * from "./like";

package/dist/schemas/index.js

@@ -32,3 +32,6 @@ __exportStar(require("./job"), exports);
 __exportStar(require("./job-application"), exports);
 __exportStar(require("./user-strike"), exports);
 __exportStar(require("./notification"), exports);
+__exportStar(require("./feed"), exports);
+__exportStar(require("./bookmark"), exports);
+__exportStar(require("./like"), exports);

package/dist/schemas/post.d.ts

@@ -264,19 +264,21 @@ export declare const PostWithLikesEntitySchema: z.ZodObject<{
     parentId: z.ZodOptional<z.ZodCUID2>;
     content: z.ZodOptional<z.ZodString>;
     likes: z.ZodArray<z.ZodObject<{
-        id: z.ZodCUID2;
-        createdAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
-        userId: z.ZodCUID2;
-        parentId: z.ZodCUID2;
-        parentType: z.ZodEnum<{
-            readonly PROJECT: "PROJECT";
-            readonly USER: "USER";
-            readonly JOB: "JOB";
-            readonly POST: "POST";
-            readonly COMMENT: "COMMENT";
-            readonly JOB_APPLICATION: "JOB_APPLICATION";
+        activityId: z.ZodCUID2;
+        activityType: z.ZodEnum<{
+            readonly LIKE: "LIKE";
+            readonly UNLIKE: "UNLIKE";
+            readonly BOOKMARK: "BOOKMARK";
+            readonly UNBOOKMARK: "UNBOOKMARK";
+            readonly VIEW: "VIEW";
         }>;
+        actorName: z.ZodString;
+        actorId: z.ZodString;
+        actorUsername: z.ZodString;
+        actorImageUrl: z.ZodOptional<z.ZodURL>;
     }, z.core.$strip>>;
+    totalFetched: z.ZodNumber;
+    totalNo: z.ZodNumber;
 }, z.core.$strip>;
 export declare const PostWithCommentsEntitySchema: z.ZodObject<{
     id: z.ZodCUID2;
@@ -308,19 +310,21 @@ export declare const PostWithBookmarksEntitySchema: z.ZodObject<{
     parentId: z.ZodOptional<z.ZodCUID2>;
     content: z.ZodOptional<z.ZodString>;
     bookmarks: z.ZodArray<z.ZodObject<{
-        id: z.ZodCUID2;
-        createdAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
-        userId: z.ZodCUID2;
-        parentId: z.ZodCUID2;
-        parentType: z.ZodEnum<{
-            readonly PROJECT: "PROJECT";
-            readonly USER: "USER";
-            readonly JOB: "JOB";
-            readonly POST: "POST";
-            readonly COMMENT: "COMMENT";
-            readonly JOB_APPLICATION: "JOB_APPLICATION";
+        activityId: z.ZodCUID2;
+        activityType: z.ZodEnum<{
+            readonly LIKE: "LIKE";
+            readonly UNLIKE: "UNLIKE";
+            readonly BOOKMARK: "BOOKMARK";
+            readonly UNBOOKMARK: "UNBOOKMARK";
+            readonly VIEW: "VIEW";
         }>;
+        actorName: z.ZodString;
+        actorId: z.ZodString;
+        actorUsername: z.ZodString;
+        actorImageUrl: z.ZodOptional<z.ZodURL>;
     }, z.core.$strip>>;
+    totalFetched: z.ZodNumber;
+    totalNo: z.ZodNumber;
 }, z.core.$strip>;
 export declare const LinkPreviewInputSchema: z.ZodObject<{
     url: z.ZodString;

package/dist/schemas/post.js

@@ -4,10 +4,9 @@ exports.SearchPostOutputSchema = exports.SearchPostInputSchema = exports.GetFeed
 const zod_openapi_1 = require("@hono/zod-openapi");
 const constants_1 = require("../constants");
 const file_1 = require("./file");
-const bookmark_1 = require("./bookmark");
 const comment_1 = require("./comment");
-const like_1 = require("./like");
 const entity_stats_1 = require("./entity-stats");
+const activity_1 = require("./activity");
 exports.PostEntitySchema = zod_openapi_1.z.object({
     id: zod_openapi_1.z
         .cuid2()
@@ -151,7 +150,9 @@ exports.MinimalPostSchema = exports.PostEntitySchema.pick({
     content: true,
 });
 exports.PostWithLikesEntitySchema = exports.MinimalPostSchema.extend({
-    likes: zod_openapi_1.z.array(like_1.LikeEntitySchema),
+    likes: zod_openapi_1.z.array(activity_1.ActivitySchema),
+    totalFetched: zod_openapi_1.z.number().int(),
+    totalNo: zod_openapi_1.z.number().int(),
 }).openapi({
     title: "PostWithPostLikesEntity",
 });
@@ -161,7 +162,9 @@ exports.PostWithCommentsEntitySchema = exports.MinimalPostSchema.extend({
     title: "PostWithPostCommentsEntity",
 });
 exports.PostWithBookmarksEntitySchema = exports.MinimalPostSchema.extend({
-    bookmarks: zod_openapi_1.z.array(bookmark_1.BookmarkEntitySchema),
+    bookmarks: zod_openapi_1.z.array(activity_1.ActivitySchema),
+    totalFetched: zod_openapi_1.z.number().int(),
+    totalNo: zod_openapi_1.z.number().int(),
 }).openapi({
     title: "PostWithPostBookmarksEntity",
 });

package/dist/schemas/project.js

@@ -9,7 +9,6 @@ const bookmark_1 = require("./bookmark");
 const view_1 = require("./view");
 const like_1 = require("./like");
 const user_1 = require("./user");
-/* ------------------------------ Core Entities ------------------------------ */
 exports.ProjectEntitySchema = zod_openapi_1.z
     .object({
     id: zod_openapi_1.z.string().openapi({

package/dist/types/feed.d.ts

@@ -0,0 +1,4 @@
+import z from "zod";
+import { FeedTagsInputSchema, FeedTagsSchema } from "../schemas/feed";
+export type FeedTagsInput = z.infer<typeof FeedTagsInputSchema>;
+export type FeedTagsOutput = z.infer<typeof FeedTagsSchema>;

package/dist/types/feed.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/index.d.ts

@@ -1,5 +1,7 @@
 export * from "./auth";
 export * from "./brand";
+export * from "./bookmark";
+export * from "./like";
 export * from "./common";
 export * from "./creative";
 export * from "./discipline";
@@ -10,6 +12,7 @@ export * from "./user";
 export * from "./comment";
 export * from "./username";
 export * from "./entity-stats";
+export * from "./feed";
 export * from "./post";
 export * from "./job-application";
 export * from "./message";

package/dist/types/index.js

@@ -16,6 +16,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./auth"), exports);
 __exportStar(require("./brand"), exports);
+__exportStar(require("./bookmark"), exports);
+__exportStar(require("./like"), exports);
 __exportStar(require("./common"), exports);
 __exportStar(require("./creative"), exports);
 __exportStar(require("./discipline"), exports);
@@ -26,6 +28,7 @@ __exportStar(require("./user"), exports);
 __exportStar(require("./comment"), exports);
 __exportStar(require("./username"), exports);
 __exportStar(require("./entity-stats"), exports);
+__exportStar(require("./feed"), exports);
 __exportStar(require("./post"), exports);
 __exportStar(require("./job-application"), exports);
 __exportStar(require("./message"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zyacreatives/shared",
-  "version": "2.1.48",
+  "version": "2.1.50",
   "description": "",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/schemas/activity.ts

@@ -0,0 +1,14 @@
+import z from "zod";
+import { ACTIVITY_TYPES } from "../constants";
+
+export const ActivitySchema = z.object({
+  activityId: z.cuid2().openapi({
+    description: "Unique identifier for the bookmarked entity.",
+    title: "Entity ID",
+  }),
+  activityType: z.enum(ACTIVITY_TYPES),
+  actorName: z.string(),
+  actorId: z.string(),
+  actorUsername: z.string(),
+  actorImageUrl: z.url().optional(),
+});

package/src/schemas/feed.ts

@@ -0,0 +1,11 @@
+import { z } from "@hono/zod-openapi";
+
+export const FeedTagsSchema = z.object({
+  userId: z.cuid2(),
+  tags: z.array(z.string()),
+});
+
+export const FeedTagsInputSchema = z.object({
+  tags: z.array(z.string()),
+});
+

package/src/schemas/index.ts

@@ -16,3 +16,6 @@ export * from "./job";
 export * from "./job-application";
 export * from "./user-strike";
 export * from "./notification";
+export * from "./feed";
+export * from "./bookmark";
+export * from "./like";

package/src/schemas/post.ts

@@ -9,6 +9,7 @@ import { BookmarkEntitySchema } from "./bookmark";
 import { CommentEntitySchema } from "./comment";
 import { LikeEntitySchema } from "./like";
 import { EntityStatsSchema } from "./entity-stats";
+import { ActivitySchema } from "./activity";
 
 export const PostEntitySchema = z.object({
   id: z
@@ -170,7 +171,9 @@ export const MinimalPostSchema = PostEntitySchema.pick({
 });
 
 export const PostWithLikesEntitySchema = MinimalPostSchema.extend({
-  likes: z.array(LikeEntitySchema),
+  likes: z.array(ActivitySchema),
+  totalFetched: z.number().int(),
+  totalNo: z.number().int(),
 }).openapi({
   title: "PostWithPostLikesEntity",
 });
@@ -182,7 +185,9 @@ export const PostWithCommentsEntitySchema = MinimalPostSchema.extend({
 });
 
 export const PostWithBookmarksEntitySchema = MinimalPostSchema.extend({
-  bookmarks: z.array(BookmarkEntitySchema),
+  bookmarks: z.array(ActivitySchema),
+  totalFetched: z.number().int(),
+  totalNo: z.number().int(),
 }).openapi({
   title: "PostWithPostBookmarksEntity",
 });

package/src/schemas/project.ts

@@ -7,7 +7,6 @@ import { ViewEntitySchema } from "./view";
 import { LikeEntitySchema } from "./like";
 import { MinimalUserSchema } from "./user";
 
-/* ------------------------------ Core Entities ------------------------------ */
 export const ProjectEntitySchema = z
   .object({
     id: z.string().openapi({

package/src/types/feed.ts

@@ -0,0 +1,5 @@
+import z from "zod";
+import { FeedTagsInputSchema, FeedTagsSchema } from "../schemas/feed";
+
+export type FeedTagsInput = z.infer<typeof FeedTagsInputSchema>;
+export type FeedTagsOutput = z.infer<typeof FeedTagsSchema>;

package/src/types/index.ts

@@ -1,5 +1,7 @@
 export * from "./auth";
 export * from "./brand";
+export * from "./bookmark";
+export * from "./like";
 export * from "./common";
 export * from "./creative";
 export * from "./discipline";
@@ -10,6 +12,7 @@ export * from "./user";
 export * from "./comment";
 export * from "./username";
 export * from "./entity-stats";
+export * from "./feed";
 export * from "./post";
 export * from "./job-application";
 export * from "./message";