@workjournal/shared 2.19.0 → 2.27.0

package/dist/__tests__/address.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=address.test.d.ts.map

package/dist/__tests__/address.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/address.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/address.test.js

@@ -0,0 +1,211 @@
+import { describe, expect, it } from 'vitest';
+import { ADDRESS_FAILURE_MESSAGES, formatAddress, formatEntryAddress, formatJournalAddress, formatWorkspaceAddress, hasAddressScheme, isAddress, MAX_ENTRY_INDEX, parseAddress, } from '../address.js';
+import { MAX_SLUG_LENGTH } from '../slug.js';
+function parsed(input) {
+    const result = parseAddress(input);
+    if (!result.ok)
+        throw new Error(`expected ${input} to parse, got ${result.reason}`);
+    return result.address;
+}
+function reason(input) {
+    const result = parseAddress(input);
+    if (result.ok)
+        throw new Error(`expected ${input} to fail, got ${formatAddress(result.address)}`);
+    return result.reason;
+}
+describe('parseAddress — valid forms', () => {
+    it('parses a workspace address', () => {
+        expect(parsed('wj:acme')).toEqual({ kind: 'workspace', workspaceSlug: 'acme' });
+    });
+    it('parses a journal address', () => {
+        expect(parsed('wj:acme.eng-notes')).toEqual({
+            kind: 'journal',
+            workspaceSlug: 'acme',
+            journalSlug: 'eng-notes',
+        });
+    });
+    it('parses an entry address', () => {
+        expect(parsed('wj:acme.eng-notes#42')).toEqual({
+            kind: 'entry',
+            workspaceSlug: 'acme',
+            journalSlug: 'eng-notes',
+            index: 42,
+        });
+    });
+    it('accepts numeric slugs', () => {
+        expect(parsed('wj:2026.q1#1')).toEqual({
+            kind: 'entry',
+            workspaceSlug: '2026',
+            journalSlug: 'q1',
+            index: 1,
+        });
+    });
+    it('accepts the maximum index', () => {
+        expect(parsed(`wj:acme.eng#${MAX_ENTRY_INDEX}`)).toMatchObject({ index: MAX_ENTRY_INDEX });
+    });
+    // The SQL backfill truncates AFTER trimming hyphens, so a live slug can end
+    // in `-`; the OpenAPI param pattern permits it too. Rejecting these would
+    // make an already-existing journal unaddressable.
+    it('accepts trailing and doubled hyphens, matching the OpenAPI slug pattern', () => {
+        expect(parsed('wj:acme-.eng--notes#1')).toMatchObject({
+            workspaceSlug: 'acme-',
+            journalSlug: 'eng--notes',
+        });
+    });
+    it('accepts slugs at the length cap', () => {
+        const slug = 'a'.repeat(MAX_SLUG_LENGTH);
+        expect(parsed(`wj:${slug}.${slug}#1`)).toMatchObject({
+            workspaceSlug: slug,
+            journalSlug: slug,
+        });
+    });
+});
+describe('parseAddress — normalisation', () => {
+    it('trims surrounding whitespace', () => {
+        expect(parsed('   wj:acme.eng-notes#7  ')).toMatchObject({ index: 7 });
+    });
+    it('lowercases scheme and slugs', () => {
+        expect(parsed('WJ:Acme.Eng-Notes#42')).toEqual({
+            kind: 'entry',
+            workspaceSlug: 'acme',
+            journalSlug: 'eng-notes',
+            index: 42,
+        });
+    });
+    it('round-trips through formatAddress in canonical form', () => {
+        expect(formatAddress(parsed('  WJ:Acme.Eng-Notes#42 '))).toBe('wj:acme.eng-notes#42');
+    });
+});
+describe('parseAddress — rejections', () => {
+    it.each([
+        ['acme.eng-notes#42', 'missing-scheme'],
+        ['https://workjournal.pro/acme', 'missing-scheme'],
+        ['acme/eng-notes/42', 'missing-scheme'],
+        ['', 'missing-scheme'],
+        ['wj:', 'empty-workspace'],
+        ['wj:.eng-notes', 'empty-workspace'],
+        ['wj:acme.', 'empty-journal'],
+        ['wj:acme.eng-notes#', 'empty-index'],
+        ['wj:acme#42', 'index-without-journal'],
+        ['wj:shared-with-me', 'virtual-workspace'],
+        ['wj:shared-with-me.eng-notes#1', 'virtual-workspace'],
+        ['wj:settings', 'reserved-slug'],
+        ['wj:acme.entries', 'reserved-slug'],
+        ['wj:acme.eng-notes#0', 'invalid-index'],
+        ['wj:acme.eng-notes#042', 'invalid-index'],
+        ['wj:acme.eng-notes#-1', 'invalid-index'],
+        ['wj:acme.eng-notes#4.2', 'invalid-index'],
+        ['wj:acme.eng-notes#abc', 'invalid-index'],
+        [`wj:acme.eng-notes#${MAX_ENTRY_INDEX + 1}`, 'invalid-index'],
+        ['wj:acme.eng.notes#1', 'invalid-slug'],
+        ['wj:acme.eng-notes#1#2', 'invalid-slug'],
+        ['wj:-acme', 'invalid-slug'],
+        ['wj:acme_notes', 'invalid-slug'],
+        ['wj:acme notes', 'invalid-slug'],
+        ['wj:café', 'invalid-slug'],
+    ])('rejects %s as %s', (input, expected) => {
+        expect(reason(input)).toBe(expected);
+    });
+    it('rejects slugs over the length cap', () => {
+        const tooLong = 'a'.repeat(MAX_SLUG_LENGTH + 1);
+        expect(reason(`wj:${tooLong}`)).toBe('invalid-slug');
+        expect(reason(`wj:acme.${tooLong}`)).toBe('invalid-slug');
+    });
+    it('has a message for every failure reason', () => {
+        const reasons = [
+            'missing-scheme',
+            'empty-workspace',
+            'empty-journal',
+            'empty-index',
+            'invalid-slug',
+            'reserved-slug',
+            'virtual-workspace',
+            'invalid-index',
+            'index-without-journal',
+        ];
+        for (const r of reasons) {
+            expect(ADDRESS_FAILURE_MESSAGES[r]).toBeTruthy();
+        }
+        expect(Object.keys(ADDRESS_FAILURE_MESSAGES).sort()).toEqual([...reasons].sort());
+    });
+});
+describe('formatAddress', () => {
+    it('formats each kind', () => {
+        expect(formatAddress({ kind: 'workspace', workspaceSlug: 'acme' })).toBe('wj:acme');
+        expect(formatAddress({ kind: 'journal', workspaceSlug: 'acme', journalSlug: 'eng-notes' })).toBe('wj:acme.eng-notes');
+        expect(formatAddress({
+            kind: 'entry',
+            workspaceSlug: 'acme',
+            journalSlug: 'eng-notes',
+            index: 42,
+        })).toBe('wj:acme.eng-notes#42');
+    });
+    it('exposes loose-slug convenience formatters', () => {
+        expect(formatWorkspaceAddress('acme')).toBe('wj:acme');
+        expect(formatJournalAddress('acme', 'eng-notes')).toBe('wj:acme.eng-notes');
+        expect(formatEntryAddress('acme', 'eng-notes', 42)).toBe('wj:acme.eng-notes#42');
+    });
+    it('normalises slug case so output is always canonical', () => {
+        expect(formatAddress({ kind: 'journal', workspaceSlug: 'Acme', journalSlug: 'Eng' })).toBe('wj:acme.eng');
+        expect(formatEntryAddress('  ACME ', 'ENG', 7)).toBe('wj:acme.eng#7');
+    });
+    // formatAddress is exported and reachable from untyped JS; its contract says
+    // the output is canonical, so it must refuse to emit an unparseable string.
+    it.each([0, -1, 1.5, Number.NaN, MAX_ENTRY_INDEX + 1])('rejects index %s', (index) => {
+        expect(() => formatAddress({ kind: 'entry', workspaceSlug: 'acme', journalSlug: 'eng', index })).toThrow(RangeError);
+    });
+    it.each(['', 'has space', 'has.dot', 'has#hash', '-leading'])('rejects slug %j', (slug) => {
+        expect(() => formatAddress({ kind: 'workspace', workspaceSlug: slug })).toThrow(TypeError);
+    });
+    // `parseAddress` rejects reserved slugs in both positions, so formatAddress
+    // emitting one would break the round-trip it documents (#782 follow-up).
+    it.each([
+        'new',
+        'settings',
+        'journals',
+        'entries',
+        'shared-with-me',
+    ])('rejects reserved workspace slug %j', (slug) => {
+        expect(() => formatAddress({ kind: 'workspace', workspaceSlug: slug })).toThrow(TypeError);
+    });
+    it.each([
+        'new',
+        'settings',
+        'invites',
+        'shared-with-me',
+    ])('rejects reserved journal slug %j', (slug) => {
+        expect(() => formatAddress({ kind: 'journal', workspaceSlug: 'acme', journalSlug: slug })).toThrow(TypeError);
+        expect(() => formatEntryAddress('acme', slug, 1)).toThrow(TypeError);
+    });
+    it('never emits a string parseAddress would reject', () => {
+        // The contract, stated as a property: anything formatAddress returns must
+        // parse back. Reserved slugs were the hole — they formatted fine and then
+        // failed to parse.
+        for (const slug of ['new', 'shared-with-me', 'settings']) {
+            expect(() => formatWorkspaceAddress(slug)).toThrow(TypeError);
+            expect(parseAddress(`wj:${slug}`).ok).toBe(false);
+        }
+    });
+    it('output of formatAddress always parses back', () => {
+        const formatted = formatEntryAddress('Acme', 'Eng-Notes', 42);
+        expect(parseAddress(formatted).ok).toBe(true);
+    });
+    it('round-trips every valid kind', () => {
+        for (const input of ['wj:acme', 'wj:acme.eng-notes', 'wj:acme.eng-notes#42']) {
+            expect(formatAddress(parsed(input))).toBe(input);
+        }
+    });
+});
+describe('isAddress / hasAddressScheme', () => {
+    it('isAddress is true only for parseable input', () => {
+        expect(isAddress('wj:acme.eng-notes#42')).toBe(true);
+        expect(isAddress('wj:acme.eng-notes#0')).toBe(false);
+        expect(isAddress('acme')).toBe(false);
+    });
+    it('hasAddressScheme is true for malformed addresses too', () => {
+        expect(hasAddressScheme('wj:acme.eng-notes#0')).toBe(true);
+        expect(hasAddressScheme('  WJ:whatever  ')).toBe(true);
+        expect(hasAddressScheme('acme')).toBe(false);
+    });
+});
+//# sourceMappingURL=address.test.js.map

package/dist/__tests__/address.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.test.js","sourceRoot":"","sources":["../../src/__tests__/address.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/export-formats.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=export-formats.test.d.ts.map

package/dist/__tests__/export-formats.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-formats.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/export-formats.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/export-formats.test.js

@@ -0,0 +1,43 @@
+import { describe, expect, it } from 'vitest';
+import { WS_API_PATHS } from '../constants.js';
+import { EXPORT_FORMAT_IDS, EXPORT_FORMATS, getExportFormat, isExportFormatId, } from '../export-formats.js';
+import { tierNamesWithFeature } from '../tiers.js';
+describe('EXPORT_FORMATS', () => {
+    it('lists every format exactly once', () => {
+        expect(EXPORT_FORMAT_IDS).toEqual(['json', 'md', 'csv', 'epub']);
+        expect(new Set(EXPORT_FORMAT_IDS).size).toBe(EXPORT_FORMATS.length);
+    });
+    it('gates EPUB behind can_export_epub and leaves the text formats open', () => {
+        expect(getExportFormat('epub').feature).toBe('can_export_epub');
+        for (const id of ['json', 'md', 'csv']) {
+            expect(getExportFormat(id).feature).toBeUndefined();
+        }
+    });
+    it('recognises only registered ids', () => {
+        expect(isExportFormatId('epub')).toBe(true);
+        expect(isExportFormatId('pdf')).toBe(false);
+        expect(isExportFormatId(undefined)).toBe(false);
+        expect(isExportFormatId('toString')).toBe(false);
+    });
+});
+describe('tierNamesWithFeature', () => {
+    const tier = (code, name, sort_order, epub) => ({ code, name, sort_order, can_export_epub: epub });
+    it('names the purchasable tiers with the flag, in upgrade order, without ADMIN', () => {
+        const tiers = [
+            tier('PRO', 'Pro', 3, true),
+            tier('ADMIN', 'Admin', 4, true),
+            tier('FREE', 'Free', 1, false),
+            tier('PLUS', 'Plus', 2, true),
+        ];
+        expect(tierNamesWithFeature(tiers, 'can_export_epub')).toEqual(['Plus', 'Pro']);
+    });
+});
+describe('WS_API_PATHS export link helpers', () => {
+    it('builds the journal-scoped mint path', () => {
+        expect(WS_API_PATHS.exportLink('acme', 'eng')).toBe('/v1/workspaces/acme/journals/eng/export-link');
+    });
+    it('builds the token download path', () => {
+        expect(WS_API_PATHS.exportDownload('abc_-1')).toBe('/v1/exports/abc_-1');
+    });
+});
+//# sourceMappingURL=export-formats.test.js.map

package/dist/__tests__/export-formats.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-formats.test.js","sourceRoot":"","sources":["../../src/__tests__/export-formats.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/notification-levels.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=notification-levels.test.d.ts.map

package/dist/__tests__/notification-levels.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-levels.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/notification-levels.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/notification-levels.test.js

@@ -0,0 +1,54 @@
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { describe, expect, it } from 'vitest';
+import { isConfigurableNotificationType, isNotificationLevel, NOTIFICATION_TYPE_GROUPS, NOTIFICATION_TYPE_OPTIONS, resolveNotificationLevel, } from '../notification-levels.js';
+describe('NOTIFICATION_TYPE_OPTIONS', () => {
+    it('has unique types, each in a known group', () => {
+        const types = NOTIFICATION_TYPE_OPTIONS.map((o) => o.type);
+        expect(new Set(types).size).toBe(types.length);
+        const groups = new Set(NOTIFICATION_TYPE_GROUPS.map((g) => g.group));
+        for (const o of NOTIFICATION_TYPE_OPTIONS)
+            expect(groups.has(o.group)).toBe(true);
+    });
+    it('scopes member.* to the workspace and everything else to journals', () => {
+        for (const o of NOTIFICATION_TYPE_OPTIONS) {
+            expect(o.scope).toBe(o.type.startsWith('member.') ? 'workspace' : 'journal');
+        }
+    });
+});
+describe('resolveNotificationLevel', () => {
+    it('defaults to list for missing keys and malformed maps', () => {
+        expect(resolveNotificationLevel(undefined, 'entry.created')).toBe('list');
+        expect(resolveNotificationLevel(null, 'entry.created')).toBe('list');
+        expect(resolveNotificationLevel([], 'entry.created')).toBe('list');
+        expect(resolveNotificationLevel({}, 'entry.created')).toBe('list');
+        expect(resolveNotificationLevel({ 'entry.created': 'loud' }, 'entry.created')).toBe('list');
+    });
+    it('returns the stored level for configurable types', () => {
+        expect(resolveNotificationLevel({ 'entry.updated': 'hide' }, 'entry.updated')).toBe('hide');
+        expect(resolveNotificationLevel({ 'member.joined': 'push' }, 'member.joined')).toBe('push');
+    });
+    it('ignores stored levels for types outside the registry', () => {
+        expect(isConfigurableNotificationType('tag.created')).toBe(false);
+        expect(resolveNotificationLevel({ 'tag.created': 'hide' }, 'tag.created')).toBe('list');
+    });
+});
+describe('isNotificationLevel', () => {
+    it('accepts exactly hide / list / push', () => {
+        expect(['hide', 'list', 'push'].every(isNotificationLevel)).toBe(true);
+        expect(isNotificationLevel('show')).toBe(false);
+        expect(isNotificationLevel(null)).toBe(false);
+    });
+});
+describe('patch_my_notification_levels SQL allow-list', () => {
+    it('matches NOTIFICATION_TYPE_OPTIONS exactly', () => {
+        // The RPC is callable directly through PostgREST, so it re-validates keys
+        // against its own copy of the registry (#805). Fail if they drift.
+        const sql = readFileSync(fileURLToPath(new URL('../../../../supabase/migrations/20261005000001_workspace_user_settings.sql', import.meta.url)), 'utf8');
+        const block = sql.match(/notification-types:begin([\s\S]*?)notification-types:end/)?.[1] ?? '';
+        const sqlTypes = [...block.matchAll(/'([a-z_]+\.[a-z_]+)'/g)].map((m) => m[1]);
+        expect(new Set(sqlTypes)).toEqual(new Set(NOTIFICATION_TYPE_OPTIONS.map((o) => o.type)));
+        expect(sqlTypes).toHaveLength(NOTIFICATION_TYPE_OPTIONS.length);
+    });
+});
+//# sourceMappingURL=notification-levels.test.js.map

package/dist/__tests__/notification-levels.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-levels.test.js","sourceRoot":"","sources":["../../src/__tests__/notification-levels.test.ts"],"names":[],"mappings":"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"}

package/dist/address.d.ts

@@ -0,0 +1,81 @@
+/**
+ * The `wj:` address standard — one notation for naming a workspace, a journal,
+ * or an entry across every surface. See `docs/addressing.md` for the spec.
+ *
+ *   wj:acme                  → workspace
+ *   wj:acme.eng-notes        → journal
+ *   wj:acme.eng-notes#42     → entry
+ *
+ * This module is the single implementation. No surface may hand-roll the
+ * grammar — `connector-app.ts` used to carry its own `ID_PATTERN` and drifting
+ * copies are exactly what this replaces.
+ */
+export declare const ADDRESS_SCHEME: "wj:";
+/**
+ * `entries.index` is a Postgres INTEGER. Rejecting above the ceiling at parse
+ * time keeps an over-large address from becoming a confusing 400 from the API.
+ */
+export declare const MAX_ENTRY_INDEX = 2147483647;
+export type WjAddress = {
+    kind: 'workspace';
+    workspaceSlug: string;
+} | {
+    kind: 'journal';
+    workspaceSlug: string;
+    journalSlug: string;
+} | {
+    kind: 'entry';
+    workspaceSlug: string;
+    journalSlug: string;
+    index: number;
+};
+export type AddressParseFailure = 'missing-scheme' | 'empty-workspace' | 'empty-journal' | 'empty-index' | 'invalid-slug' | 'reserved-slug' | 'virtual-workspace' | 'invalid-index' | 'index-without-journal';
+export type ParseAddressResult = {
+    ok: true;
+    address: WjAddress;
+} | {
+    ok: false;
+    reason: AddressParseFailure;
+};
+/** Human-readable explanation per failure reason, for CLI/MCP error messages. */
+export declare const ADDRESS_FAILURE_MESSAGES: Readonly<Record<AddressParseFailure, string>>;
+/**
+ * Parse a `wj:` address.
+ *
+ * Liberal in what it accepts — surrounding whitespace is trimmed and the input
+ * is lowercased, so `WJ:Acme.Eng-Notes#42` parses — but the parsed result is
+ * always canonical, so `formatAddress(parse(x))` is a normalising round-trip.
+ *
+ * Returns a `reason` rather than throwing (or returning bare `null`) so callers
+ * can render something the user can act on: "uses a reserved slug" is
+ * actionable where "malformed" is not.
+ */
+export declare function parseAddress(input: string): ParseAddressResult;
+/**
+ * Render an address in canonical form. Inverse of `parseAddress`.
+ *
+ * Normalises slug case and rejects anything that would produce an unparseable
+ * string. The type system stops most misuse, but `formatAddress` is exported
+ * and reachable from untyped JS, and its documented contract is that the
+ * output is *canonical* — silently emitting `wj:Acme.eng#0` would break that
+ * for every consumer that later parses it back.
+ */
+export declare function formatAddress(address: WjAddress): string;
+/** Convenience formatters for callers holding loose slugs rather than a union. */
+export declare function formatWorkspaceAddress(workspaceSlug: string): string;
+export declare function formatJournalAddress(workspaceSlug: string, journalSlug: string): string;
+export declare function formatEntryAddress(workspaceSlug: string, journalSlug: string, index: number): string;
+/**
+ * Cheap check for "does this look like an address" — used to decide whether to
+ * treat a CLI positional as an address or as a bare slug. Note this returns
+ * false for a malformed address; use `parseAddress` when you need to tell a
+ * non-address apart from a broken one.
+ */
+export declare function isAddress(input: string): boolean;
+/**
+ * True when the input is *trying* to be an address, valid or not. The CLI uses
+ * this to route a `wj:`-prefixed positional into the address parser so a typo
+ * reports the real reason instead of being treated as a workspace slug.
+ */
+export declare function hasAddressScheme(input: string): boolean;
+//# sourceMappingURL=address.d.ts.map

package/dist/address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.d.ts","sourceRoot":"","sources":["../src/address.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,cAAc,EAAG,KAAc,CAAC;AAE7C;;;GAGG;AACH,eAAO,MAAM,eAAe,aAAa,CAAC;AAsB1C,MAAM,MAAM,SAAS,GAClB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAC/D;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhF,MAAM,MAAM,mBAAmB,GAC5B,gBAAgB,GAChB,iBAAiB,GACjB,eAAe,GACf,aAAa,GACb,cAAc,GACd,eAAe,GACf,mBAAmB,GACnB,eAAe,GACf,uBAAuB,CAAC;AAE3B,MAAM,MAAM,kBAAkB,GAC3B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,SAAS,CAAA;CAAE,GAChC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,mBAAmB,CAAA;CAAE,CAAC;AAE9C,iFAAiF;AACjF,eAAO,MAAM,wBAAwB,EAAE,QAAQ,CAAC,MAAM,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAWlF,CAAC;AAUF;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,CAwD9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,SAAS,GAAG,MAAM,CAkBxD;AAiBD,kFAAkF;AAClF,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAEvF;AAED,wBAAgB,kBAAkB,CACjC,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,GACX,MAAM,CAER;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEvD"}

package/dist/address.js

@@ -0,0 +1,192 @@
+import { SHARED_WITH_ME_SLUG } from './constants.js';
+import { isReservedSlug, MAX_SLUG_LENGTH } from './slug.js';
+/**
+ * The `wj:` address standard — one notation for naming a workspace, a journal,
+ * or an entry across every surface. See `docs/addressing.md` for the spec.
+ *
+ *   wj:acme                  → workspace
+ *   wj:acme.eng-notes        → journal
+ *   wj:acme.eng-notes#42     → entry
+ *
+ * This module is the single implementation. No surface may hand-roll the
+ * grammar — `connector-app.ts` used to carry its own `ID_PATTERN` and drifting
+ * copies are exactly what this replaces.
+ */
+export const ADDRESS_SCHEME = 'wj:';
+/**
+ * `entries.index` is a Postgres INTEGER. Rejecting above the ceiling at parse
+ * time keeps an over-large address from becoming a confusing 400 from the API.
+ */
+export const MAX_ENTRY_INDEX = 2147483647;
+/**
+ * Slug shape shared by both address positions. Deliberately identical to the
+ * OpenAPI `pattern` already documented on the workspace/journal slug params
+ * (`^[a-z0-9][a-z0-9-]{0,39}$`) — the length half is applied separately below.
+ *
+ * Note this is looser than `slugify()`'s own output: it tolerates a trailing
+ * hyphen and doubled hyphens. That is deliberate. The SQL backfill in
+ * `20260422000002_add_slug_columns` truncates with `substring(... FOR 30)`
+ * *after* trimming hyphens, so a live slug can legitimately end in `-`.
+ * Rejecting those here would make an existing journal unaddressable.
+ *
+ * What the parser actually depends on is narrower: a slug can never contain
+ * `.`, `#`, or `:`. That is what makes the grammar unambiguous, and it is the
+ * invariant the DB CHECK constraint enforces.
+ */
+const SLUG_PATTERN = /^[a-z0-9][a-z0-9-]*$/;
+/** Positive integer, no leading zeros. Mirrors the old connector-app pattern. */
+const INDEX_PATTERN = /^[1-9]\d*$/;
+/** Human-readable explanation per failure reason, for CLI/MCP error messages. */
+export const ADDRESS_FAILURE_MESSAGES = {
+    'missing-scheme': `Address must start with "${ADDRESS_SCHEME}"`,
+    'empty-workspace': 'Address is missing a workspace slug',
+    'empty-journal': 'Address has a "." but no journal slug',
+    'empty-index': 'Address has a "#" but no entry number',
+    'invalid-slug': 'Slugs must start with a lowercase letter or digit and contain only lowercase letters, digits, and hyphens',
+    'reserved-slug': 'Address uses a reserved slug',
+    'virtual-workspace': `"${SHARED_WITH_ME_SLUG}" is a virtual listing, not an addressable workspace — use the journal's real workspace slug`,
+    'invalid-index': `Entry number must be a positive integer with no leading zeros, at most ${MAX_ENTRY_INDEX}`,
+    'index-without-journal': 'Address has an entry number but no journal slug',
+};
+function isValidSlug(value) {
+    return value.length <= MAX_SLUG_LENGTH && SLUG_PATTERN.test(value);
+}
+function fail(reason) {
+    return { ok: false, reason };
+}
+/**
+ * Parse a `wj:` address.
+ *
+ * Liberal in what it accepts — surrounding whitespace is trimmed and the input
+ * is lowercased, so `WJ:Acme.Eng-Notes#42` parses — but the parsed result is
+ * always canonical, so `formatAddress(parse(x))` is a normalising round-trip.
+ *
+ * Returns a `reason` rather than throwing (or returning bare `null`) so callers
+ * can render something the user can act on: "uses a reserved slug" is
+ * actionable where "malformed" is not.
+ */
+export function parseAddress(input) {
+    const normalized = input.trim().toLowerCase();
+    if (!normalized.startsWith(ADDRESS_SCHEME))
+        return fail('missing-scheme');
+    const rest = normalized.slice(ADDRESS_SCHEME.length);
+    // Split on the LAST `#` and the FIRST `.`. Safe because neither character
+    // can occur inside a slug — a second `.` or `#` lands inside a segment and
+    // is rejected by the slug check rather than silently re-splitting.
+    const hashAt = rest.lastIndexOf('#');
+    const head = hashAt === -1 ? rest : rest.slice(0, hashAt);
+    const indexPart = hashAt === -1 ? null : rest.slice(hashAt + 1);
+    const dotAt = head.indexOf('.');
+    const workspacePart = dotAt === -1 ? head : head.slice(0, dotAt);
+    const journalPart = dotAt === -1 ? null : head.slice(dotAt + 1);
+    if (indexPart !== null && journalPart === null)
+        return fail('index-without-journal');
+    if (workspacePart.length === 0)
+        return fail('empty-workspace');
+    if (!isValidSlug(workspacePart))
+        return fail('invalid-slug');
+    // Checked before the general reserved test so the caller gets the specific
+    // reason — `shared-with-me` is in RESERVED_SLUGS too, but it fails for a
+    // different reason than a route-collision name would.
+    if (workspacePart === SHARED_WITH_ME_SLUG)
+        return fail('virtual-workspace');
+    if (isReservedSlug(workspacePart))
+        return fail('reserved-slug');
+    if (journalPart === null) {
+        return { ok: true, address: { kind: 'workspace', workspaceSlug: workspacePart } };
+    }
+    if (journalPart.length === 0)
+        return fail('empty-journal');
+    if (!isValidSlug(journalPart))
+        return fail('invalid-slug');
+    if (isReservedSlug(journalPart))
+        return fail('reserved-slug');
+    if (indexPart === null) {
+        return {
+            ok: true,
+            address: { kind: 'journal', workspaceSlug: workspacePart, journalSlug: journalPart },
+        };
+    }
+    if (indexPart.length === 0)
+        return fail('empty-index');
+    if (!INDEX_PATTERN.test(indexPart))
+        return fail('invalid-index');
+    const index = Number(indexPart);
+    if (index > MAX_ENTRY_INDEX)
+        return fail('invalid-index');
+    return {
+        ok: true,
+        address: {
+            kind: 'entry',
+            workspaceSlug: workspacePart,
+            journalSlug: journalPart,
+            index,
+        },
+    };
+}
+/**
+ * Render an address in canonical form. Inverse of `parseAddress`.
+ *
+ * Normalises slug case and rejects anything that would produce an unparseable
+ * string. The type system stops most misuse, but `formatAddress` is exported
+ * and reachable from untyped JS, and its documented contract is that the
+ * output is *canonical* — silently emitting `wj:Acme.eng#0` would break that
+ * for every consumer that later parses it back.
+ */
+export function formatAddress(address) {
+    const workspaceSlug = normalizeSlugOrThrow(address.workspaceSlug, 'workspaceSlug');
+    if (address.kind === 'workspace') {
+        return `${ADDRESS_SCHEME}${workspaceSlug}`;
+    }
+    const journalSlug = normalizeSlugOrThrow(address.journalSlug, 'journalSlug');
+    if (address.kind === 'journal') {
+        return `${ADDRESS_SCHEME}${workspaceSlug}.${journalSlug}`;
+    }
+    const { index } = address;
+    if (!Number.isInteger(index) || index < 1 || index > MAX_ENTRY_INDEX) {
+        throw new RangeError(`formatAddress: index must be an integer in 1..${MAX_ENTRY_INDEX}, got ${String(index)}`);
+    }
+    return `${ADDRESS_SCHEME}${workspaceSlug}.${journalSlug}#${index}`;
+}
+function normalizeSlugOrThrow(slug, field) {
+    const normalized = typeof slug === 'string' ? slug.trim().toLowerCase() : '';
+    if (!isValidSlug(normalized)) {
+        throw new TypeError(`formatAddress: ${field} is not a valid slug: ${JSON.stringify(slug)}`);
+    }
+    // `parseAddress` rejects reserved slugs in both positions, so emitting one
+    // would produce a string that cannot be parsed back — breaking the canonical
+    // round-trip this function documents. `shared-with-me` is in RESERVED_SLUGS,
+    // so this covers the virtual-workspace case too.
+    if (isReservedSlug(normalized)) {
+        throw new TypeError(`formatAddress: ${field} is a reserved slug: ${JSON.stringify(slug)}`);
+    }
+    return normalized;
+}
+/** Convenience formatters for callers holding loose slugs rather than a union. */
+export function formatWorkspaceAddress(workspaceSlug) {
+    return formatAddress({ kind: 'workspace', workspaceSlug });
+}
+export function formatJournalAddress(workspaceSlug, journalSlug) {
+    return formatAddress({ kind: 'journal', workspaceSlug, journalSlug });
+}
+export function formatEntryAddress(workspaceSlug, journalSlug, index) {
+    return formatAddress({ kind: 'entry', workspaceSlug, journalSlug, index });
+}
+/**
+ * Cheap check for "does this look like an address" — used to decide whether to
+ * treat a CLI positional as an address or as a bare slug. Note this returns
+ * false for a malformed address; use `parseAddress` when you need to tell a
+ * non-address apart from a broken one.
+ */
+export function isAddress(input) {
+    return parseAddress(input).ok;
+}
+/**
+ * True when the input is *trying* to be an address, valid or not. The CLI uses
+ * this to route a `wj:`-prefixed positional into the address parser so a typo
+ * reports the real reason instead of being treated as a workspace slug.
+ */
+export function hasAddressScheme(input) {
+    return input.trim().toLowerCase().startsWith(ADDRESS_SCHEME);
+}
+//# sourceMappingURL=address.js.map