@alwith/module-store 0.1.0

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, including WorkBuddy
+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/README.md

@@ -0,0 +1,20 @@
+# @alwith/module-store
+
+TypeScript side of alwith-store, distributed under the accompanying proprietary license.
+createStoreClient binds Desktop's existing named-store API to a supplied StorePort.
+The app selects its connection and persistence backend; this package never opens a
+Runtime or chooses data directories. Each client owns its own store-handle cache.
+
+The port is storage-only: no QA, editor or Desktop business types. Existing change
+events identify store/key, not scope; that transport limitation is unchanged.
+No user data or preferences are migrated by this extraction.
+
+## License and redistribution
+
+See [LICENSE](LICENSE) and [third-party notices](THIRD_PARTY_NOTICES.md).
+ALwith-owned code is proprietary, not open source. You may build, customize, host,
+charge for and distribute your own WorkBuddy applications under the included
+license, without per-application registration. This does not grant hosted-service
+access or rights to separately distributed Rust libraries or Runtime binaries.
+The npm artifact includes compiled/minified JS, declarations and necessary assets,
+not the private TS/TSX implementation or source maps. Minification is not encryption.

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,17 @@
+# Third-party notices — @alwith/module-store
+
+ALwith's proprietary license applies only to its own material. Third-party
+material retains its original license and rights; the package license does not
+replace or restrict those rights. Preserve applicable notices when redistributing.
+
+## External direct dependencies and peers
+
+These are external imports, not bundled dependency implementations in this npm
+artifact. Versions below record the local release-preparation inventory; declared
+ranges can resolve to different versions. Keep the notices from the versions
+actually distributed by your application, including transitive dependencies.
+
+| Package | Inspected version | License | Included license copy |
+| --- | --- | --- | --- |
+
+No external direct runtime dependencies or peers are declared in this package.

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+export interface AlwithStore {
+    get<T>(key: string): Promise<T | undefined>;
+    set(key: string, value: unknown): Promise<void>;
+    has(key: string): Promise<boolean>;
+    delete(key: string): Promise<void>;
+    keys(): Promise<string[]>;
+    values<T>(): Promise<T[]>;
+    entries<T>(): Promise<[key: string, value: T][]>;
+    clear(): Promise<void>;
+    reload(): Promise<void>;
+    length(): Promise<number>;
+    onKeyChange<T>(key: string, listener: (value: T | undefined) => void): Promise<() => void>;
+    onChange<T>(listener: (key: string, value: T | undefined) => void): Promise<() => void>;
+}
+export type StoreScope = "data" | "cache";
+export interface StorePort {
+    storeEntries(scope: StoreScope, store: string): Promise<Record<string, unknown>>;
+    storeSet(scope: StoreScope, store: string, key: string, value: unknown): Promise<void>;
+    storeDelete(scope: StoreScope, store: string, key: string): Promise<void>;
+    storeClear(scope: StoreScope, store: string): Promise<void>;
+    storeReload(scope: StoreScope, store: string): Promise<void>;
+    onStoreChanged(handler: (change: {
+        store: string;
+        key: string;
+        value: unknown;
+    }) => void): Promise<() => void>;
+}
+export declare function createStoreClient(createHostPort: () => StorePort): {
+    openStore: (name: string, scope?: StoreScope) => AlwithStore;
+};

package/dist/index.js

@@ -0,0 +1 @@
+function o(s){class i{scope;name;constructor(e,t){this.scope=e,this.name=t}entriesObject(){return s().storeEntries(this.scope,this.name)}async get(e){return(await this.entriesObject())[e]}async set(e,t){await s().storeSet(this.scope,this.name,e,t)}async has(e){return Object.hasOwn(await this.entriesObject(),e)}async delete(e){await s().storeDelete(this.scope,this.name,e)}async keys(){return Object.keys(await this.entriesObject())}async values(){return Object.values(await this.entriesObject())}async clear(){await s().storeClear(this.scope,this.name)}async reload(){await s().storeReload(this.scope,this.name)}async entries(){return Object.entries(await this.entriesObject())}async length(){return Object.keys(await this.entriesObject()).length}onKeyChange(e,t){return this.onChange((n,a)=>{if(n===e)t(a)})}onChange(e){return s().onStoreChanged((t)=>{if(t.store===this.name)e(t.key,t.value)})}}let r=new Map;function h(e,t="data"){let n=`${t}:${e}`,a=r.get(n);if(a)return a;let c=new i(t,e);return r.set(n,c),c}return{openStore:h}}export{o as createStoreClient};

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@alwith/module-store",
+  "version": "0.1.0",
+  "private": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "THIRD_PARTY_NOTICES.md",
+    "licenses"
+  ],
+  "devDependencies": {
+    "typescript": "^7.0.2"
+  },
+  "scripts": {
+    "test": "bun test src",
+    "typecheck": "tsc --noEmit",
+    "build": "bun ../../../scripts/build-npm.ts",
+    "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": "crates/store/guest-js"
+  }
+}