@isi-ui7/bos7-shared 0.2.0

package/dist/shell/app-shell-layout.d.ts

@@ -0,0 +1,70 @@
+import { ReactNode } from 'react';
+
+export interface AppShellAuthState {
+    isAuthenticated: boolean;
+    isLoading: boolean;
+    user: {
+        name?: string | null;
+        email?: string | null;
+        roles?: string[] | null;
+        branch_id?: string | null;
+    } | null;
+    login: () => void;
+    logout: () => Promise<void> | void;
+}
+export type ShellNavItemLike = any;
+export interface ShellNotificationLike {
+    id?: string;
+    read?: boolean;
+    [key: string]: unknown;
+}
+interface RouterLike {
+    push: (href: string) => void;
+}
+interface ThemeLike {
+    displayName?: string;
+}
+interface NotificationBellLike {
+    badgeCount: number;
+    markAllRead: () => void;
+    onItemClick: (n: ShellNotificationLike) => void;
+    fetchBadge: () => void;
+}
+interface NotificationBellOptionsLike {
+    apiBase?: string;
+    enabled?: boolean;
+    onNavigate?: (href: string) => void;
+}
+export type AppSwitchMode = "push" | "location";
+export interface AppShellLayoutDeps {
+    usePathname: () => string;
+    useRouter: () => RouterLike;
+    useTheme: () => {
+        theme: ThemeLike;
+    };
+    useNotificationBell: (opts: NotificationBellOptionsLike) => NotificationBellLike;
+    GlobalTheme: any;
+    ModalProvider: any;
+    UiShell: any;
+    useAuth?: () => AppShellAuthState;
+}
+export interface AppShellLayoutProps {
+    children: ReactNode;
+    deps: AppShellLayoutDeps;
+    navItems: ShellNavItemLike[];
+    markActive: (items: ShellNavItemLike[], pathname: string) => ShellNavItemLike[];
+    appNameFallback: string;
+    auth7UiUrlFallback?: string;
+    portalUrlFallback?: string;
+    roleFallback?: string;
+    appSwitchMode?: AppSwitchMode;
+    resolveNotificationHref?: (href: string, navigate: (href: string) => void) => void;
+    notificationsViewAllHref?: string;
+    notificationsViewAllTarget?: string;
+    hideMenuButton?: boolean;
+    disableAppsMenu?: boolean;
+    sideNavMode?: "drilldown" | "overlay";
+    sideNavItems?: ShellNavItemLike[];
+}
+export declare function AppShellLayout({ children, deps, navItems, markActive, appNameFallback, auth7UiUrlFallback, portalUrlFallback, roleFallback, appSwitchMode, resolveNotificationHref, notificationsViewAllHref, notificationsViewAllTarget, hideMenuButton, disableAppsMenu, sideNavMode, sideNavItems, }: AppShellLayoutProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/shell/branch.d.ts

@@ -0,0 +1,6 @@
+export declare function switchBranchById(branchId: string, endpoint?: string): Promise<boolean>;
+export declare function setupBranchVisibilitySync(currentBranchId: string | null | undefined, options?: {
+    cookieName?: string;
+    endpoint?: string;
+    onSynced?: () => void;
+}): () => void;

package/dist/shell/interaction.d.ts

@@ -0,0 +1,2 @@
+export type ShellProfileAction = "profile" | "change-password" | "logout" | string;
+export declare function handleShellProfileAction(action: ShellProfileAction, auth7UiUrl: string, onLogout: () => void): void;

package/dist/shell/provider.d.ts

@@ -0,0 +1,15 @@
+import { ComponentType, ReactNode } from 'react';
+
+type ProviderLayoutProps = {
+    children: ReactNode;
+};
+type SharedShellProviderProps = {
+    children: ReactNode;
+    Layout: ComponentType<ProviderLayoutProps>;
+};
+type SharedShellProviderOptions = {
+    withAuth?: boolean;
+    dictionaries?: Partial<Record<"id" | "en", Record<string, string>>>;
+};
+export declare function createShellProvider(options?: SharedShellProviderOptions): ({ children, Layout }: SharedShellProviderProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/style-contract.d.ts

@@ -0,0 +1,72 @@
+export type Ui7FormDensity = "compact" | "comfortable";
+export type Ui7ThemeDensity = Ui7FormDensity | "normal";
+export interface Ui7FormVisualTokens {
+    labelSpacing: "6px";
+    labelFontSize: "12px";
+    labelFontWeight: 500;
+    labelLineHeight: "16px";
+    inputFontSize: "14px";
+    inputFontWeight: 400;
+    inputLineHeight: "20px";
+    controlHeight: "40px";
+    textareaMinHeight: "88px";
+    rowGap: "16px";
+    sectionGap: "24px";
+    columnGap: "16px";
+    readonlyBackground: "#f4f4f4";
+    readonlyCursor: "default";
+}
+export declare const UI7_FORM_VISUAL_TOKENS: Ui7FormVisualTokens;
+export declare const UI7_FORM_VISUAL_CSS_VARS: {
+    readonly labelSpacing: "--ui7-form-label-gap";
+    readonly labelFontSize: "--ui7-form-label-font-size";
+    readonly labelFontWeight: "--ui7-form-label-font-weight";
+    readonly labelLineHeight: "--ui7-form-label-line-height";
+    readonly inputFontSize: "--ui7-form-input-font-size";
+    readonly inputFontWeight: "--ui7-form-input-font-weight";
+    readonly inputLineHeight: "--ui7-form-input-line-height";
+    readonly controlHeight: "--ui7-form-control-height";
+    readonly textareaMinHeight: "--ui7-form-textarea-min-height";
+    readonly rowGap: "--ui7-form-row-gap";
+    readonly sectionGap: "--ui7-form-section-gap";
+    readonly columnGap: "--ui7-form-column-gap";
+    readonly density: "--ui7-form-density";
+    readonly readonlyBackground: "--ui7-form-readonly-background";
+    readonly readonlyCursor: "--ui7-form-readonly-cursor";
+};
+export declare const UI7_FORM_VISUAL_CLASSNAMES: {
+    readonly scope: "ui7-form-contract";
+    readonly densityCompact: "ui7-form-contract--density-compact";
+    readonly densityComfortable: "ui7-form-contract--density-comfortable";
+    readonly readonly: "ui7-form-contract--readonly";
+    readonly row: "ui7-form-row";
+    readonly section: "ui7-form-section";
+    readonly column: "ui7-form-column";
+    readonly label: "ui7-form-label";
+    readonly labelRequired: "ui7-form-label__required";
+    readonly control: "ui7-form-control";
+    readonly controlReadonly: "ui7-form-control--readonly";
+    readonly helper: "ui7-form-helper";
+    readonly readonlyValue: "ui7-form-readonly-value";
+};
+export declare const UI7_FORM_DENSITY_TOKENS: {
+    readonly compact: {
+        readonly controlHeight: "2rem";
+        readonly rowGap: "0.75rem";
+        readonly sectionGap: "1rem";
+        readonly columnGap: "0.75rem";
+    };
+    readonly comfortable: {
+        readonly controlHeight: "2.5rem";
+        readonly rowGap: "1rem";
+        readonly sectionGap: "1.5rem";
+        readonly columnGap: "1rem";
+    };
+};
+export declare function normalizeUi7FormDensity(density?: Ui7ThemeDensity | null, fallback?: Ui7FormDensity): Ui7FormDensity;
+export declare function getUi7FormDensityClassName(density?: Ui7ThemeDensity | null, fallback?: Ui7FormDensity): string;
+export declare function getUi7FormContractClassName(options?: {
+    density?: Ui7ThemeDensity | null;
+    readonly?: boolean;
+    className?: string | null;
+}): string;

package/dist/types/core.d.ts

@@ -0,0 +1,39 @@
+export interface QueryParams {
+    cursor?: string;
+    pageSize?: number;
+    sortBy?: string;
+    sortDir?: 'asc' | 'desc';
+    search?: string;
+    filters?: Record<string, unknown>;
+}
+export interface QueryResult<T> {
+    data: T[];
+    nextCursor?: string;
+    prevCursor?: string;
+    total?: number;
+}
+export interface OffsetPage<T> {
+    data: T[];
+    total: number;
+    page: number;
+    per_page: number;
+    total_pages: number;
+}
+export interface OffsetQueryParams {
+    page?: string;
+    per_page?: string;
+    sort_by?: string;
+    sort_dir?: 'asc' | 'desc';
+    search?: string;
+    [key: string]: string | undefined;
+}
+export type ServiceAction = 'get' | 'simpan' | 'hapus';
+export interface ServiceRequest<T = unknown> {
+    payload?: T;
+}
+export interface ServiceResponse<T = unknown> {
+    ok: boolean;
+    data?: T;
+    error?: string;
+}
+export type { Notification, Notif7Raw, NotificationListResponse, UnreadCountResponse } from '../types/notification';

package/dist/types/notification.d.ts

@@ -0,0 +1,30 @@
+export interface Notification {
+    id: string;
+    user_id: string;
+    event_type: string;
+    title: string;
+    message: string;
+    is_read: boolean;
+    action_url?: string;
+    created_at: string;
+}
+export interface Notif7Raw {
+    ID: string;
+    UserID: string;
+    EventType: string;
+    Title: string;
+    Body: string;
+    IsRead: boolean;
+    RefURL?: string;
+    CreatedAt: string;
+    Source?: string;
+    Channel?: string;
+}
+export interface NotificationListResponse {
+    data: Notification[];
+    next_cursor?: string;
+    total?: number;
+}
+export interface UnreadCountResponse {
+    unread_count: number;
+}

package/dist/workflow/api-client.d.ts

@@ -0,0 +1,2 @@
+declare const apiClient: import('axios').AxiosInstance;
+export default apiClient;

package/dist/workflow/backend.d.ts

@@ -0,0 +1,9 @@
+export interface WorkflowBackendRequestOptions {
+    query?: URLSearchParams;
+    body?: string;
+    contentType?: string;
+    accessToken?: string;
+}
+declare function request(method: string, path: string, options?: WorkflowBackendRequestOptions): Promise<Response>;
+export { request as backendRequest };
+export declare function safeProxyJson(res: Response): Promise<Response>;

package/dist/workflow/crud-client.d.ts

@@ -0,0 +1,3 @@
+export declare function fetchDetailData<T>(url: string): Promise<T>;
+export declare function submitWorkflowForm<TPayload>(url: string, method: 'POST' | 'PUT' | 'PATCH', payload: TPayload): Promise<string>;
+export declare function submitWorkflowDelete(url: string): Promise<string>;

package/dist/workflow/notif7.d.ts

@@ -0,0 +1,6 @@
+export interface WorkflowNotif7RequestOptions {
+    accessToken?: string;
+    query?: URLSearchParams;
+    body?: string;
+}
+export declare function notif7Request(method: string, path: string, options?: WorkflowNotif7RequestOptions): Promise<Response>;

package/dist/workflow/starter.d.ts

@@ -0,0 +1,44 @@
+type CookieReqLike = Request & {
+    cookies?: {
+        get?: (name: string) => {
+            value?: string;
+        } | undefined;
+    };
+};
+/** Read the user access_token cookie from a Next.js API route request. */
+export declare function getUserAccessToken(req: CookieReqLike | Request): string | undefined;
+/** UUID idempotency key — used as external_ref and embedded in workflow payload. */
+export declare function newWfIdempotencyKey(): string;
+export type StartWorkflowInput = {
+    flowId: string;
+    payload: Record<string, unknown>;
+    externalRef?: string;
+    initiatorContext?: {
+        user_id?: string;
+        branch_id?: string;
+    };
+    /** User access token dari auth7 — diforward ke workflow7 sebagai Bearer. */
+    userAccessToken: string;
+};
+export type StartWorkflowResult = {
+    ok: boolean;
+    instanceId?: string;
+    status?: string;
+    error?: string;
+};
+export declare function startWorkflow(input: StartWorkflowInput): Promise<StartWorkflowResult>;
+export type WfStartedBody = {
+    instance_id?: string;
+    wf_instance_id: string;
+    status: string;
+};
+/**
+ * Standard 202 envelope for "workflow started" responses.
+ * `instanceId` is workflow7's instance UUID (used by SSE RefID match);
+ * `idempotencyKey` is the external_ref/wf_instance_id (financing service uses it
+ * as upsert idempotency key).
+ */
+export declare function respondWfStarted(result: StartWorkflowResult, idempotencyKey: string): Response;
+/** Standard 401 envelope when access_token cookie missing. */
+export declare function respondUnauthorized(): Response;
+export {};

package/dist/workflow/use-crud-form.d.ts

@@ -0,0 +1,27 @@
+import { CrudForm, FormMode } from '../form-types';
+
+export type UseCrudFormOptions<TData extends Record<string, unknown>> = {
+    schema: CrudForm<TData>;
+    mode: FormMode;
+    /** Route params used for API path interpolation, e.g. { id: "123" }. Memoize to avoid re-loads. */
+    params?: Record<string, string>;
+    /** Called with workflow instance_id on successful submit. */
+    onSuccess?: (instanceId: string) => void;
+};
+export type UseCrudFormReturn<TData extends Record<string, unknown>> = {
+    form: TData;
+    setForm: (patch: Partial<TData>) => void;
+    loading: boolean;
+    saving: boolean;
+    error: string | null;
+    fieldErrors: Partial<Record<keyof TData, string>>;
+    isDirty: boolean;
+    page: number;
+    pageCount: number;
+    isLastPage: boolean;
+    canGoPrev: boolean;
+    goNext: () => Promise<void>;
+    goPrev: () => void;
+    handleSave: () => Promise<void>;
+};
+export declare function useCrudForm<TData extends Record<string, unknown>>({ schema, mode, params, onSuccess, }: UseCrudFormOptions<TData>): UseCrudFormReturn<TData>;

package/dist/workflow/use-workflow-tracker.d.ts

@@ -0,0 +1,40 @@
+export type WfNotifEvent = {
+    EventType?: string;
+    event_type?: string;
+    RefID?: string;
+    ref_id?: string;
+    Payload?: {
+        instance_id?: string;
+        workflow_id?: string;
+        result?: string;
+        reason?: string;
+    };
+    payload?: {
+        instance_id?: string;
+        workflow_id?: string;
+        result?: string;
+        reason?: string;
+    };
+};
+export type WfCompletionResult = {
+    status: 'success' | 'error';
+    /** Human-readable detail from payload.result (success) or payload.reason (error). */
+    message?: string;
+};
+export type UseWorkflowTrackerOptions = {
+    /** SSE endpoint. Default: `/api/notifications/stream`. */
+    streamUrl?: string;
+    /** Event types treated as "workflow done". Default: all three terminal event types. */
+    completionEventTypes?: string[];
+    /** Fired when a tracked instance reaches a terminal state. */
+    onComplete?: (instanceId: string, result: WfCompletionResult) => void;
+    /** Disable subscription (e.g. when the page is not visible). Default: true. */
+    enabled?: boolean;
+};
+export type UseWorkflowTrackerReturn = {
+    /** Register a workflow instance UUID to watch for completion. */
+    track: (instanceId: string | undefined) => void;
+    /** Read-only snapshot of currently-tracked instance IDs. */
+    pending: () => string[];
+};
+export declare function useWorkflowTracker(options?: UseWorkflowTrackerOptions): UseWorkflowTrackerReturn;

package/package.json

@@ -0,0 +1,92 @@
+{
+  "name": "@isi-ui7/bos7-shared",
+  "version": "0.2.0",
+  "description": "Shared auth7 and layout primitives for bos7 applications.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ihsansolusi/ui7.git",
+    "directory": "packages/bos7-shared"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "peerDependencies": {
+    "react": ">=18",
+    "react-dom": ">=18",
+    "next": "16.x",
+    "@isi-ui7/corporate-themes": ">=0.2.0",
+    "@isi-ui7/i18n": ">=0.1.0",
+    "@isi-ui7/ui-shell": ">=0.2.0",
+    "@isi-ui7/modal-manager": ">=0.2.0",
+    "@isi-ui7/realtime": ">=0.2.0",
+    "@carbon/react": "^1.97.0",
+    "@carbon/icons-react": "^11.71.0",
+    "@isi-ui7/data-table": ">=0.2.0",
+    "@isi-ui7/lookup-input": ">=0.2.0"
+  },
+  "devDependencies": {
+    "@eslint/eslintrc": "^3.3.1",
+    "@eslint/js": "^9.39.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.52.0",
+    "@typescript-eslint/parser": "^8.52.0",
+    "@vitejs/plugin-react": "^4.2.0",
+    "@testing-library/dom": "^10.0.0",
+    "@testing-library/react": "^16.0.0",
+    "@testing-library/user-event": "^14.5.0",
+    "eslint": "9.39.2",
+    "eslint-config-prettier": "^9.1.0",
+    "eslint-plugin-jsx-a11y": "^6.7.1",
+    "eslint-plugin-react": "^7.33.2",
+    "eslint-plugin-react-hooks": "^4.6.2",
+    "jsdom": "^22.1.0",
+    "typescript": "^5.3.3",
+    "vite": "^5.0.0",
+    "vite-plugin-dts": "^3.6.0",
+    "vitest": "^1.0.0",
+    "next": "16.1.1",
+    "@carbon/react": "^1.97.0",
+    "@carbon/icons-react": "^11.71.0",
+    "@isi-ui7/i18n": "0.2.0",
+    "@isi-ui7/data-table": "0.2.1",
+    "@isi-ui7/realtime": "0.2.2",
+    "@isi-ui7/corporate-themes": "0.2.2",
+    "@isi-ui7/lookup-input": "0.2.1",
+    "@isi-ui7/ui-shell": "0.2.2",
+    "@isi-ui7/modal-manager": "0.2.1"
+  },
+  "dependencies": {
+    "@carbon/icons-react": "^11.71.0",
+    "@carbon/react": "^1.97.0",
+    "jose": "^5.9.6",
+    "xlsx": "^0.18.5",
+    "jspdf": "^4.2.1",
+    "jspdf-autotable": "^5.0.7",
+    "axios": "^1.7.7",
+    "@opentelemetry/sdk-node": "^0.57.0",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.57.0",
+    "@opentelemetry/auto-instrumentations-node": "^0.57.0",
+    "@isi-ui7/data-table": "0.2.1",
+    "@isi-ui7/lookup-input": "0.2.1"
+  },
+  "scripts": {
+    "build": "vite build",
+    "lint": "eslint \"src/**/*.{ts,tsx}\"",
+    "test": "vitest run --passWithNoTests",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/src/api.ts

@@ -0,0 +1,40 @@
+// Shared API abstraction layer for BOS7 apps.
+// Browser always talks to Next.js BFF routes via relative /api/* path.
+
+import type { QueryParams, QueryResult, ServiceAction, ServiceRequest, ServiceResponse } from './types/core';
+
+const BASE_URL = '';
+
+export async function queryList<T>(domain: string, params: QueryParams): Promise<QueryResult<T>> {
+  const res = await fetch(`${BASE_URL}/api/${domain}`, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify(params),
+  });
+
+  if (!res.ok) {
+    throw new Error(`queryList(${domain}) gagal: ${res.status} ${res.statusText}`);
+  }
+
+  return res.json() as Promise<QueryResult<T>>;
+}
+
+export async function callService<T>(
+  domain: string,
+  action: ServiceAction,
+  payload?: unknown
+): Promise<ServiceResponse<T>> {
+  const body: ServiceRequest = { payload };
+
+  const res = await fetch(`${BASE_URL}/api/${domain}/service/${action}`, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify(body),
+  });
+
+  if (!res.ok) {
+    throw new Error(`callService(${domain}, ${action}) gagal: ${res.status} ${res.statusText}`);
+  }
+
+  return res.json() as Promise<ServiceResponse<T>>;
+}