@alwith/module-collection 0.0.0-stage → 0.0.2

package/LICENSE

@@ -0,0 +1,94 @@
+ALwith Developer and Redistribution License, Version 1.0
+Copyright 2026 ALWITHAI PTE. LTD. All rights reserved, except as expressly granted below.
+
+1. Scope
+This license applies only to ALWITHAI PTE. LTD.'s ("ALwith") own material in
+the npm package accompanying this license (the "Software"). It is a proprietary
+license, not an open-source license. Third-party material is governed by its
+respective licenses, as described in THIRD_PARTY_NOTICES.md. No restriction here
+reduces rights granted by those licenses or by mandatory applicable law.
+
+2. Permission to develop and distribute applications
+Subject to this license, ALwith grants you a worldwide, non-exclusive, royalty-free
+copyright license to use, reproduce, integrate and modify the supplied Software
+to develop, test, host and operate your own applications, for personal,
+internal business or commercial use. You may brand,
+sell and distribute those applications, including the Software embedded in them,
+to your customers and end users. No per-application registration, approval or
+royalty is required by this software license.
+
+You may bundle, minify, transform and otherwise adapt the supplied JavaScript,
+styles and declarations for those applications. You may include the supplied
+Software in an application source distribution when necessary to build or use
+that application, provided it remains separately identified under this license.
+You may combine it with separately licensed application code, including MPL-2.0
+code, while complying with both licenses. Your own independent code remains yours;
+this license does not require disclosure of your application source code.
+
+Recipients may use the embedded Software to run the application and exercise the
+permissions above under this same license. You may allow your contractors and
+hosting providers to use it for those purposes. You must supply this license and
+all applicable third-party notices with each redistribution (for example in an
+included licenses directory or an accessible legal-notices page), identify your
+modifications, and not impose terms that purport to change ALwith's license.
+
+3. Rights reserved
+No right to ALwith's unpublished source code, private repositories, trademarks,
+or separately distributed Runtime binaries, modules or services is granted here.
+You may not relicense the Software as your own framework or redistribute it as
+a standalone SDK/package for others, except for private development/build caches
+used for applications permitted by Section 2. No restriction is imposed on
+independently developed competing applications or on third-party licensed code.
+You must not misrepresent authorship or imply ALwith endorses your application.
+
+4. Accounts and services
+This license does not supply platform credentials, paid entitlements, hosting,
+support, updates or a service-availability guarantee. Use of ALwith accounts,
+pets, relay or other hosted services is separately subject to the applicable
+service terms and authorization. Do not bypass service access controls or use
+another person's credentials without authorization. Choosing or replacing an
+authentication provider for your own application is not prohibited by this
+software license. Distributing an Auth client does not authorize its recipients
+to access another user's account, data or entitlements.
+
+5. Lawful use and independent responsibility
+You must not use the Software to commit or knowingly facilitate unlawful acts.
+You are responsible for your application's operation, permissions, business
+practices, data processing, content and compliance with applicable law. You must
+not make warranties or commitments on ALwith's behalf. ALwith does not endorse
+your application merely because it uses the Software or connects to ALwith.
+These allocations do not remove either party's own mandatory legal obligations.
+
+6. Disclaimer and limitation of liability
+TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, THE SOFTWARE IS PROVIDED
+"AS IS" AND "AS AVAILABLE", WITHOUT EXPRESS OR IMPLIED WARRANTIES, INCLUDING
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, ACCURACY,
+SECURITY OR UNINTERRUPTED OPERATION. AI OUTPUTS AND AUTOMATED ACTIONS MAY BE
+INCORRECT OR HARMFUL; YOU MUST DETERMINE APPROPRIATE REVIEW AND SAFEGUARDS.
+
+TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, ALWITH AND ITS CONTRIBUTORS
+ARE NOT LIABLE FOR DAMAGES ARISING FROM USE, MODIFICATION OR DISTRIBUTION OF
+THE SOFTWARE, INCLUDING LOST PROFITS, LOST DATA, BUSINESS INTERRUPTION AND
+INDIRECT OR CONSEQUENTIAL LOSS. NOTHING EXCLUDES OR LIMITS LIABILITY THAT
+CANNOT LAWFULLY BE EXCLUDED OR LIMITED, INCLUDING APPLICABLE MANDATORY CONSUMER
+RIGHTS AND LIABILITY FOR FRAUD, WILLFUL MISCONDUCT OR GROSS NEGLIGENCE WHERE
+SUCH EXCLUSION OR LIMITATION IS PROHIBITED. THIS LICENSE DOES NOT EXCLUDE
+CRIMINAL OR REGULATORY RESPONSIBILITY IMPOSED BY LAW.
+
+7. Duration and termination
+The grant for this version continues while you comply with this license. If
+ALwith gives written notice of a material breach, your rights terminate if you
+do not cure it within 30 days; no cure period authorizes continuing unlawful
+conduct. On termination, cease new use and distribution of ALwith's proprietary
+Software except as required by law. Independently compliant recipients retain
+their own grants. Sections concerning reserved rights, notices, disclaimers and
+mandatory-law exceptions survive as applicable. Third-party licenses are not
+terminated by this provision.
+
+8. Versions and severability
+This license governs the accompanying version. A later license or publication
+of source code does not retroactively replace this grant or revoke rights in
+earlier lawfully obtained versions. Any additional open-source license must be
+expressly identified by ALwith. If a provision is unenforceable, the remaining
+provisions continue to the extent permitted by law. A separate written agreement
+signed by you and ALwith may expressly override these terms for its stated scope.

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,5 @@
+# Third-party notices — @alwith/module-collection
+
+This package contains ALwith's collection model and no bundled third-party code.
+It has no runtime dependencies. The accompanying ALwith Developer and
+Redistribution License applies to this package's own material.

package/dist/index.d.ts

@@ -0,0 +1,95 @@
+export declare const DEFAULT_COLLECTION_ID = "collection-default";
+export interface Collection {
+    id: string;
+    name: string;
+    nameIsCustom?: boolean;
+    collapsed: boolean;
+    emoji?: string;
+    sessionIds: string[];
+}
+export interface SessionMeta {
+    title?: string;
+    cwd?: string;
+    titleOverride?: boolean;
+}
+export interface CollectionData {
+    collections: Record<string, Collection>;
+    order: string[];
+    sessionMeta: Record<string, SessionMeta>;
+}
+export type CollectionAction = {
+    type: "create";
+    id: string;
+    name: string;
+    emoji?: string;
+    sessionId?: string;
+    sourceCollectionId?: string;
+} | {
+    type: "rename";
+    id: string;
+    name: string;
+    emoji?: string;
+} | {
+    type: "emoji";
+    id: string;
+    emoji: string;
+} | {
+    type: "collapse";
+    id: string;
+    collapsed: boolean;
+} | {
+    type: "clear" | "delete";
+    id: string;
+} | {
+    type: "add";
+    collectionId: string;
+    sessionId: string;
+} | {
+    type: "materialize";
+    collectionId: string;
+    sessionId: string;
+    cwd: string;
+} | {
+    type: "move";
+    sourceCollectionId: string;
+    collectionId: string;
+    sessionId: string;
+    index?: number;
+} | {
+    type: "reorder";
+    id: string;
+    index: number;
+} | {
+    type: "remove";
+    sessionId: string;
+    collectionId?: string;
+} | {
+    type: "forget";
+    sessionId: string;
+} | {
+    type: "favorite";
+    sessionId: string;
+} | {
+    type: "meta";
+    sessionId: string;
+    meta: SessionMeta;
+} | {
+    type: "renameSession";
+    sessionId: string;
+    title: string;
+};
+export declare function getCollectionName(collection: Collection, t: (key: "collection.defaultFavorites") => string): string;
+export declare function initialCollectionData(): CollectionData;
+export declare function applyCollectionAction(state: CollectionData, action: CollectionAction): CollectionData;
+export interface LegacyCollections {
+    collections: Record<string, {
+        id: string;
+        name: string;
+        collapsed: boolean;
+        emoji?: string;
+        sessionIds?: string[];
+    }>;
+    order: string[];
+    sessionMeta?: Record<string, SessionMeta>;
+}
+export declare function migrateCollections(legacy: LegacyCollections[], current?: CollectionData): CollectionData;

package/dist/index.js

@@ -0,0 +1 @@
+var f="collection-default";function m(o,e){return o.id==="collection-default"?e("collection.defaultFavorites"):o.name}function c(){return{collections:{["collection-default"]:{id:"collection-default",name:"",nameIsCustom:!1,collapsed:!1,sessionIds:[]}},order:["collection-default"],sessionMeta:{}}}function u(o,e){let r={...o.collections},n=(s,d)=>{if(!r[s])throw Error(`Collection missing: ${s}`);r[s]={...r[s],...d}},i=(s,d)=>n(s,{sessionIds:r[s].sessionIds.filter((t)=>t!==d)}),l=(s,d)=>{let t=r[s];if(!t)throw Error(`Collection missing: ${s}`);for(let I of o.order)if(I!==s&&r[I].sessionIds.includes(d))i(I,d);if(!t.sessionIds.includes(d))n(s,{sessionIds:[...t.sessionIds,d],collapsed:!1})};switch(e.type){case"create":{if(!e.name.trim())throw Error("Collection name is empty");if(r[e.id]={id:e.id,name:e.name.trim(),...e.emoji===void 0?{}:{emoji:e.emoji},collapsed:!1,sessionIds:[]},e.sessionId!==void 0){if(e.sourceCollectionId!==void 0)i(e.sourceCollectionId,e.sessionId);l(e.id,e.sessionId)}return{...o,collections:r,order:[...o.order,e.id]}}case"rename":if(e.id==="collection-default")throw Error("Default collection cannot be renamed");if(!e.name.trim())throw Error("Collection name is empty");n(e.id,{name:e.name.trim(),nameIsCustom:!0,...e.emoji===void 0?{}:{emoji:e.emoji}});break;case"collapse":n(e.id,{collapsed:e.collapsed});break;case"emoji":n(e.id,{emoji:e.emoji});break;case"clear":n(e.id,{sessionIds:[]});break;case"delete":if(e.id==="collection-default")throw Error("Default collection cannot be deleted");return delete r[e.id],{...o,collections:r,order:o.order.filter((s)=>s!==e.id)};case"add":l(e.collectionId,e.sessionId);break;case"materialize":return l(e.collectionId,e.sessionId),{...o,collections:r,sessionMeta:{...o.sessionMeta,[e.sessionId]:{...o.sessionMeta[e.sessionId],cwd:e.cwd}}};case"move":{i(e.sourceCollectionId,e.sessionId),l(e.collectionId,e.sessionId);let d=r[e.collectionId].sessionIds.filter((t)=>t!==e.sessionId);d.splice(e.index??d.length,0,e.sessionId),n(e.collectionId,{sessionIds:d,collapsed:!1});break}case"reorder":{if(e.id==="collection-default")throw Error("Default collection cannot be reordered");let s=o.order.filter((d)=>d!==e.id);return s.splice(e.index,0,e.id),{...o,order:s}}case"forget":{for(let d of o.order)i(d,e.sessionId);let s={...o.sessionMeta};return delete s[e.sessionId],{...o,collections:r,sessionMeta:s}}case"remove":for(let s of e.collectionId===void 0?o.order:[e.collectionId])i(s,e.sessionId);break;case"favorite":if(o.order.some((s)=>r[s].sessionIds.includes(e.sessionId)))for(let s of o.order)i(s,e.sessionId);else l("collection-default",e.sessionId);break;case"meta":{let s=o.sessionMeta[e.sessionId],d={...s};if(e.meta.cwd!==void 0)d.cwd=e.meta.cwd;if(e.meta.title!==void 0&&!s?.titleOverride)d.title=e.meta.title;if(s?.cwd===d.cwd&&s?.title===d.title)return o;return{...o,sessionMeta:{...o.sessionMeta,[e.sessionId]:d}}}case"renameSession":{let s=e.title.trim();return{...o,sessionMeta:{...o.sessionMeta,[e.sessionId]:{...o.sessionMeta[e.sessionId],title:s||void 0,titleOverride:s.length>0}}}}}return{...o,collections:r}}function C(o,e=c()){let r={collections:{...e.collections},order:[...e.order],sessionMeta:{...e.sessionMeta}};for(let n of o){for(let[i,l]of Object.entries(n.sessionMeta??{})){let s=r.sessionMeta[i];r.sessionMeta[i]=s?.titleOverride?{...l,...s}:{...s,...l}}for(let i of n.order){if(i==="collection-default")continue;let l=n.collections[i];if(!l)throw Error(`Persisted collection missing: ${i}`);let s=r.collections[i];if(r.collections[i]={...l,...e.collections[i],sessionIds:[...new Set([...s?.sessionIds??[],...l.sessionIds??[]])]},!r.order.includes(i))r.order.push(i)}}return r}export{f as DEFAULT_COLLECTION_ID,u as applyCollectionAction,m as getCollectionName,c as initialCollectionData,C as migrateCollections};

package/package.json

@@ -1,6 +1,32 @@
 {
   "name": "@alwith/module-collection",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.0.2",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "THIRD_PARTY_NOTICES.md"
+  ],
+  "scripts": {
+    "build": "bun ../../scripts/build-npm.ts",
+    "test": "bun test src",
+    "prepack": "bun run build"
+  },
+  "license": "SEE LICENSE IN LICENSE",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ALwith-ai/alwith-modules.git",
+    "directory": "packages/collection"
+  }
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.